__setstow

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.

Low Level I/O

See Also    _close, __note