The function pulls file from the remote device. Different combinations of remoteFilename and contentType are used to pull different kind of objects from the remote device. For example 'x-obex/folder-listing' for contentType retrives current folder listing if the server supports it.

Parameters:

session

- Session to be used in push.

localFilename

- Local filename.

remoteFilename

- Remote filename.

contentType

- The content(or MIME) type of the file.

Returns:

OBEX_ERROR_SUCCESS if function succeeds.

OBEX_ERROR_INVALID_PARAMETER if invalid parameters are passed to function.

OBEX_ERROR_OUT_OF_MEMORY if out of memory.

ObexResponseCode if server responds with something other than success.

Push local file to the server using given session. The local file can be full path. To ensure compatibility with different devices it is adviced to use SetPath to set the current path and only use the file name in the remoteFileName.

Parameters:

session

- Session to be used in push.

localFilename

- Local filename. The file to be sent.

remoteFilename

- The name for the remote file.

contentType

- The content(MIME) type of the file.

Remarks:

Either remoteFilename or contentType must be specified.

Returns:

OBEX_ERROR_SUCCESS if function succeeds.

OBEX_ERROR_INVALID_PARAMETER if invalid parameters are passed to function.

OBEX_ERROR_OUT_OF_MEMORY if out of memory.

ObexResponseCode if server responds with something other than success.

The function is used to set the current path in the remote device and also to create new folders. Function sends OBEX_PACKET_OPERATION_SET_PATH to the server with the given path. The OBEX_SETPATH_NO_CREATE flag prevents the server from creating new folder if the folder specified is not there. OBEX_SETPATH_REVERSE flag is used when going backwards in the directory hierarchy( cd .. ).

Remarks:

Advance one directory at one function call to ensure maximum compatibility.

Use the OBEX_SETPATH_REVERSE | OBEX_SETPATH_NO_CREATE without path parameter to reverse the directory tree.

Parameters:

session

- Session to be used in setPath.

path

- New path.

flags

- Behaviour flags.

Returns:

OBEX_ERROR_SUCCESS if function succeeds.

OBEX_ERROR_INVALID_PARAMETER if invalid parameters are passed to function.

OBEX_ERROR_OUT_OF_MEMORY if out of memory.

ObexResponseCode if server responds with something other than success.