TwclCustomObexClient.Connect(TGUID,TGUID,string,Word) Method
Connects to an OBEX server.
protected function Connect(const Target: TGUID; const Who: TGUID; const Description: string; const PacketSize: Word): Integer;
Parameters
- Target
- Type: TGUID
Specifies the UUID of the desired application. If the
Target
is not used it must be set to NULL GUID. - Who
- Type: TGUID
Can also be used when it is necessary to identify the client initiating the exchange. If the
Who
is not used it must be set to NULL GUID. - Description
- Type: string
Provides an information about the device or service. If the
Description
is not used it must be set to an empty string. - PacketSize
- Type: Word
The maximum OBEX packet size. The minimum allowed value is 0x00FF.
Return Value
If the function succeed the return value is wclErrors.WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.
Target
and Who
are used to hold a unique
identifier, which allows applications to tell whether they are
talking to a strict peer, or not. Typically, this is used to enable
additional capabilities supplied only by an exact peer.
On full-featured [PC] platforms, multiple OBEX applications may
exist concurrently. This leads to the need for the client to be able
to uniquely identify which server it wants to handle its request. The
server is therefore identified with the OBEX Target
header. If
necessary, the client can also identify itself, using the OBEX
Who
header. The following text describes the exact uses of these
headers.
To target a specific application with OBEX commands the client
must set-up a connection to the application by using the OBEX
Target
header in a CONNECT request. This type of connection is
called a directed connection and provides a virtual binding between
the client and server. The Target
header should specify the
UUID of the desired application. The Who
header can also be
used when it is necessary to identify the client initiating the
exchange. The Who
header should be used in cases where
the target server application supports different client applications
and may care which one it is connecting to. It is unnecessary to send
a Who
header in the request if its only logical value is the
same as the Target
header.