Set Directory (17)
The Set Directory operation (B_SET_DIR) sets the current directory to a specified pathname.
Parameters
Op Code
Pos Block
Data Buf
Data Buf Len
Key Buffer
Key Number
Sent
Returned
Prerequisites
The target logical disk drive and directory must be accessible.
Procedure
1
Set the Operation Code to 17.
2
Store the logical disk drive and directory path, terminated by a binary 0, in the Key Buffer. If you omit the drive name, the transactional interface uses the default drive. If you do not specify the complete path for the directory, the transactional interface appends the directory path specified in the Key Buffer to the current directory.
For details about path names supported by Pervasive PSQL clients, see
Network Path Formats Supported by Pervasive Requesters
in
Getting Started With Pervasive PSQL
.
Result
If the Set Directory operation is successful, the transactional interface makes the directory specified in the Key Buffer the current directory.
If the Set Directory operation is unsuccessful, the transactional interface leaves the current directory unchanged and returns a nonzero status code.
Positioning
The Set Directory operation has no effect on positioning.