Sets aux. close information for member names.
int __setstow (int handle, char * buffer, long length, int ttrn);
Required Header |
<io.h> |
Return Value
This function returns 0 if the operation was successful. -1 indicates an error.
Parameters
handle
The low level I/O handle to the open file
buffer
A pointer to the user-data to store in the directory
length
The length in bytes of the user-data (later converted to halfwords.)
ttrn
The number of TTRs contained in the user-data
Remarks
The __setstow function stores a copy of user directory information, for use when the file handle is finally closed. This information is not normally required, but allows finer control over members of load-library data sets which must contain the required information. The length parameter must be an even number between 0 and 62 inclusive, and ttrn must be between 0 and 3 inclusive.
Use _fileno to get the low-level handle of a stream.
Not all file types allow user-data, use this function with caution.