AddPrinterConnection
The AddPrinterConnection
function adds a connection to the specified printer for the current user.
BOOL AddPrinterConnection (
|
LPTSTR pName |
// pointer to
printer name |
|
); |
|
Parameters
pName
Pointer to a
null-terminated string that specifies the name of a printer that the current
user wishes to establish a connection to.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
When Windows
NT makes a connection to a printer, it may need to copy printer driver files to
the workstation. If the user does not have permission to copy files to the
appropriate location, the AddPrinterConnection function fails, and GetLastError returns
ERROR_ACCESS_DENIED.
A printer
connection established by calling AddPrinterConnection will be
enumerated when EnumPrinters is called with dwType set to
PRINTER_ENUM_CONNECTION.
See Also