User Manual

218
CATC MERLIN’S WAND 1.22 APPENDIX C
User’s Manual Merlin’s Wand Scripting Commands
Examples
In these examples, the server’s OBEX directory is assumed to be
c:\obexdir.
#store file to "file.txt" in server’s OBEX directory
# (i.e., c:\obexdir\file.txt)
OBEXClientPut("c:\\temp\\file.txt");
#store file to "newfile.txt" in server’s OBEX dir
# (i.e., c:\obexdir\newfile.txt)
OBEXClientPut("c:\\temp\\file.txt", "newfile.txt");
#store file to "newfile.txt" in temp dir under OBEX dir
# (i.e., c:\obexdir\temp\newfile.txt)
OBEXClientPut("c:\\temp\\file.txt", "temp\\newfile.txt");
OBEXClientSetPath()
OBEXClientSetPath(Path, Flags)
Return value
• “Success”
• “Failure”
• “Failed: Busy”
• “Failed: Not connected”
• “Failed: Packet too small”
• “Failed: Invalid parameter”
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.