Client Support

An OBEX client initiates an underlying transport connection to an OBEX server. The following commands are used to establish and release this connection:

• Connect enables the client to connect to an OBEX server through the OBEX layer. To obtain a list of available devices, the client calls the IObex::EnumDevices method. Each device exposes a Connect method. If an OBEX server does not exist on the device, the connection fails. Transport-specific information is hidden from the user; only the name and address is exposed.
• Disconnect releases the client/server connection and frees associated resources.

Once a connection is established, the client can issue the following commands:

• Put pushes data from the local device to the OBEX server.
• Get pulls data from the OBEX server, providing the server allows this function.
• Abort terminates a multipacket Put or Get method
• SetPath sets the current browsing directory on the OBEX server or creates a new directory.

For more information on how these commands are used, see the following examples:

• Connecting to an OBEX Server
• Disconnecting from an OBEX Server
• Requesting a Data Object from the OBEX Server
• Sending a Data Object to the OBEX Server
• Aborting a Request
• Setting the Target Folder Path on the OBEX Server

See Also

Device Discovery | Object Exchange Interfaces | Connection Points | Use of Streams | Object Exchange Protocol

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.