 | wclCustomObexClientSetPath Method |
Changes the current directory on a server's side.
Namespace: wclCommunicationAssembly: wclCommunication (in wclCommunication.dll) Version: 8.0.6.0
Syntaxprotected int SetPath(
string Dir,
bool Create
)
Protected Function SetPath (
Dir As String,
Create As Boolean
) As Integer
protected:
int SetPath(
String^ Dir,
bool Create
)
Parameters
- Dir String
-
A new directory name. If the Dir parameter's value is
".." it tells to a server to backup a level (go one level up).
If the Dir parameter is an empty string it tells to a server to
go to the default (root) directory).
- Create Boolean
-
If this parameter's value is True a server creates new
directory with the given name. If this parameter's value is
False and a directory specified in the Dir parameter
does not exist the WCL_E_OBEX_BAD_REQUEST
or the WCL_E_OBEX_FORBIDDEN error returned as
the operation complete result.
Return Value
Int32
Remarks
The method sets the current directory on a receiving side in order to
enable transfers that need additional path information. For instance,
when a nested set of directories is sent between two machines,
SetPath is used to create the directory structure on the receiving
side.
See Also