int printer_get_name ( char **name );

char **name;        

Synopsis

#include "silver.h"

The printer_get_name function obtains a name for the currently selected Windows printer. This name may be saved and used in a subsequent call to printer_set_name.

Parameters

name is the address of a character pointer which is to receive the address of an allocated buffer that contains the name.

Return Value

printer_get_name returns 0 if the buffer may not be allocated, or there is no current Windows printer, and 1 otherwise.

Comments

*name should be freed via a call to free.

See Also

printer_set_name

Note

The function printer_get_name_s should be used in place of printer_get_name in all new code. It is a safer version of this function, particularly in SilverPlus and SilverSharp environments and when linked with a different Standard C library.