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 |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
AddPrinterConnectionW (Unicode) e AddPrinterConnectionA (ANSI) |