Funzione ConfigurePort
La funzione ConfigurePort visualizza la finestra di dialogo configurazione porta per una porta nel server specificato.
Sintassi
BOOL ConfigurePort(
_In_ LPTSTR pName,
_In_ HWND hWnd,
_In_ LPTSTR pPortName
);
Parametri
-
pName [in]
-
Puntatore a una stringa con terminazione null che specifica il nome del server in cui esiste la porta specificata. Se questo parametro è NULL, la porta è locale.
-
hWnd [in]
-
Gestire nella finestra padre della finestra di dialogo configurazione porta.
-
pPortName [in]
-
Puntatore a una stringa con terminazione null che specifica il nome della porta da configurare.
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à con cui questa funzione restituisce 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. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.
Prima di chiamare la funzione ConfigurePort , un'applicazione deve chiamare la funzione EnumPorts per determinare i nomi di porta validi.
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 |
ConfigurePortW (Unicode) e ConfigurePortA (ANSI) |