Teledyne LeCroy BTTracer_Trainer - BTTrainer Users Manual - Manual (Page 241)

223
CATC BTT RAINER 2.11 C HAPTER
User’s Manual
OBEXClientSetPath
OBEXClientSetPath(Path, Flags)
Return value
• “Success”
• “Failure”
• “Failed: Busy”
• “Failed: Not connected”
• “Failed: Packet too small”
• “Failed: Invalid parameter”
Comments
Temporarily changes a server's current working directory, accessed by cli-
ents during ClientGet and ClientPut operations. The device must be
connected to an OBEX server before the command can be successfully
executed. The change is lost when the connection is broken. Note that the
server’s OBEX root directory cannot be changed with this command.
If the path includes multiple levels, be sure to use double-slashes to sepa-
rate components (e.g., “temp1\\temp2”). Using single slashes will cause
errors.
Example
#set path to
status = OBEXClientSetPath("", 0);
Sleep(1000);
#set path to \temp2
status = OBEXClientSetPath("temp2", 0);
Parameter Meaning Default Value Comments
Path New path to
set
Path is relative to server’s current working direc-
tory. Cannot begin “C:” or “\\\\”.
Flags SetPath flags:
0=No flags
1=Back up
one level
2=Don’t cre-
ate specified
folder if it
doesn’t exist
3=Back up
one level and
don't create
specified
folder
When backup is set (flag = 1 or 3), the working
directory is backed up one level before the speci-
fied directory is appended (e.g., if the server’s
current working directory is C:\Temp, a SetPath
of “Temp2” with a flag of 1 would change the
directory to C:\Temp2). To set path to the OBEX
root directory, use an empty path and a flag of 0
or 2.