Funzione AddPort

La funzione AddPort aggiunge il nome di una porta all'elenco delle porte supportate. La funzione AddPort viene esportata dal monitoraggio delle porte.

Sintassi

BOOL AddPort(
  _In_ LPTSTR pName,
  _In_ HWND   hWnd,
  _In_ LPTSTR pMonitorName
);

Parametri

pName [in]

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

hWnd [in]

Handle per la finestra padre della finestra di dialogo AddPort .

pMonitorName [in]

Puntatore a una stringa con terminazione zero che specifica il monitoraggio associato alla porta.

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.

La funzione AddPort esplora la rete per trovare le porte esistenti e visualizza una finestra di dialogo per l'utente. La funzione AddPort deve convalidare il nome della porta immesso dall'utente chiamando EnumPorts per assicurarsi che non esistano nomi duplicati.

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

Per aggiungere una porta senza visualizzare una finestra di dialogo, chiamare la funzione XcvData anziché AddPort. Per altre informazioni su XcvData, vedere Microsoft Windows Driver Development Kit (DDK).

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	Spoolss.dll
Nomi Unicode e ANSI	AddPortW (Unicode) e AddPortA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

DeletePort

EnumPorts

SetPort