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	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	WinSpool.drv

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

AddPrinterConnection

ClosePrinter

DeletePrinter

DeletePrinterConnection

GetPrinter

PRINTER_INFO_2