Funzione DeletePort

La funzione DeletePort visualizza una finestra di dialogo che consente all'utente di eliminare un nome di porta.

Sintassi

BOOL DeletePort(
  _In_ LPTSTR pName,
  _In_ HWND   hWnd,
  _In_ LPTSTR pPortName
);

Parametri

pName [in]

Puntatore a una stringa con terminazione zero che specifica il nome del server per cui eliminare la porta. Se questo parametro è NULL, viene eliminata una porta locale.

hWnd [in]

Handle per la finestra padre della finestra di dialogo di eliminazione delle porte.

pPortName [in]

Puntatore a una stringa con terminazione zero che specifica il nome della porta da eliminare.

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.

Un'applicazione può recuperare i nomi delle porte valide chiamando la funzione EnumPorts .

La funzione DeletePort restituisce un errore se una stampante è attualmente connessa alla porta specificata.

Il chiamante della funzione DeletePort deve avere SERVER_ACCESS_ADMINISTER accesso al server a cui è connessa la porta.

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	DeletePortW (Unicode) e DeletePortA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

AddPort

EnumPorts