Funzione ConnectToPrinterDlg
La funzione ConnectToPrinterDlg visualizza una finestra di dialogo che consente agli utenti di esplorare e connettersi alle stampanti in una rete. Se l'utente seleziona una stampante, la funzione tenta di crearvi una connessione; se nel server non è installato un driver appropriato, l'utente ha la possibilità di creare una stampante in locale.
Sintassi
HANDLE ConnectToPrinterDlg(
_In_ HWND hwnd,
_In_ DWORD Flags
);
Parametri
-
hwnd [in]
-
Specifica la finestra padre della finestra di dialogo.
-
Flag [in]
-
Questo parametro è riservato e deve essere zero.
Valore restituito
Se la funzione ha esito positivo e l'utente seleziona una stampante, il valore restituito è un handle per la stampante selezionata.
Se la funzione ha esito negativo o l'utente annulla la finestra di dialogo senza selezionare una stampante, il valore restituito è NULL.
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.
La funzione ConnectToPrinterDlg tenta di creare una connessione alla stampante selezionata. Tuttavia, se il server in cui risiede la stampante non dispone di un driver appropriato installato, la funzione offre all'utente la possibilità di creare una stampante in locale. Un'applicazione chiamante può determinare se la funzione ha creato una stampante in locale chiamando GetPrinter con una struttura PRINTER_INFO_2 , quindi esaminando il membro Attributes della struttura.
Un'applicazione deve chiamare DeletePrinter per eliminare una stampante locale. Un'applicazione deve chiamare DeletePrinterConnection per eliminare una connessione a una stampante.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|