get_tape_status


unsigned get_tape_status(handle file)

This function is used to ascertain whether a tape is ready to process commands.

Parameters

handle file

The handle of the tape device. This handle is obtained via the function create_file.

Return

unsigned

If the tape is ready to accept commands, the value zero is returned; otherwise, one of the win+ error codes is returned.