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

Set the Operation Code to 17.

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 more information about path names Pervasive PSQL supports, refer to 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.