Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_file_unlink() function unlinks (removes) the file that mi_file_open() has previously opened.

mi_integer mi_file_unlink(fd)

mi_integer fd;

fd	is the file descriptor of the file to be removed. It is obtained by a previous call to mi_file_open().

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
No	Yes

The mi_file_unlink() function removes the operating-system file that fd identifies. This function is a destructor function for an operating-system file descriptor.

A call to mi_file_unlink() from a client LIBMI application raises an exception.

The mi_file_unlink() function does not throw an MI_Exception event when it encounters a runtime error. Therefore, it does not cause callbacks to be invoked.

See the description of the mi_file_open() function.