Funzione AddPrinterConnection

La funzione AddPrinterConnection aggiunge una connessione alla stampante specificata per l'utente corrente.

Sintassi

BOOL AddPrinterConnection(
  _In_ LPTSTR pName
);

Parametri

pName [in]

Puntatore a una stringa con terminazione Null che specifica il nome di una stampante a cui l'utente corrente desidera stabilire una connessione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.

Quando Windows stabilisce una connessione a una stampante, potrebbe essere necessario copiare i file del driver della stampante nel server in cui è collegata la stampante. Se l'utente non dispone dell'autorizzazione per copiare i file nel percorso appropriato, la funzione AddPrinterConnection ha esito negativo e GetLastError restituisce ERROR_ACCESS_DENIED.

Una connessione alla stampante stabilita chiamando AddPrinterConnection verrà enumerata quando EnumPrinters viene chiamato con dwType impostato su PRINTER_ENUM_CONNECTION.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	AddPrinterConnectionW (Unicode) e AddPrinterConnectionA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

ConnectToPrinterDlg

DeletePrinterConnection

Enumprinters