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