Teledyne LeCroy Merlins Wand - Users Manual - Manual (Page 234)

218
CATC M ERLIN ’ S W AND 2.00 C HAPTER C
User’s Manual Merlin’s Wand Scripting Commands
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 <root>
status = OBEXClientSetPath("", 0);
Sleep(1000);
#set path to <root>\temp2
status = OBEXClientSetPath("temp2", 0);
Sleep(1000);
#set path to <root>\temp2\temp3
status = OBEXClientSetPath("temp3", 0);
Sleep(1000);
#set path to <root>\temp2
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.
Parameter Meaning Default Value Comments