Funzione EnumMonitors
La funzione EnumMonitors recupera informazioni sui monitoraggi delle porte installati nel server specificato.
Sintassi
BOOL EnumMonitors(
_In_ LPTSTR pName,
_In_ DWORD Level,
_Out_ LPBYTE pMonitors,
_In_ DWORD cbBuf,
_Out_ LPDWORD pcbNeeded,
_Out_ LPDWORD pcReturned
);
Parametri
-
pName [in]
-
Puntatore a una stringa con terminazione Null che specifica il nome del server in cui risiedono i monitoraggi. Se questo parametro è NULL, i monitoraggi locali vengono enumerati.
-
Livello [in]
-
Versione della struttura a cui punta pMonitors.
Questo valore può essere 1 o 2.
-
pMonitors [out]
-
Puntatore a un buffer che riceve una matrice di strutture. Il buffer deve essere sufficientemente grande da archiviare le stringhe a cui fanno riferimento i membri della struttura.
Per determinare le dimensioni del buffer necessarie, chiamare EnumMonitors con cbBuf impostato su zero. EnumMonitors ha esito negativo, GetLastError restituisce ERROR_INSUFFICIENT_BUFFER e il parametro pcbNeeded restituisce le dimensioni, in byte, del buffer necessario per contenere la matrice di strutture e i relativi dati.
Il buffer riceve una matrice di strutture MONITOR_INFO_1 se Level è 1 o MONITOR_INFO_2 strutture se Level è 2.
-
cbBuf [in]
-
Dimensione, in byte, del buffer a cui punta pMonitors.
-
pcbNeeded [out]
-
Puntatore a una variabile che riceve il numero di byte copiati se la funzione ha esito positivo o il numero di byte necessari se cbBuf è troppo piccolo.
-
pcReturned [out]
-
Puntatore a una variabile che riceve il numero di strutture restituite nel buffer a cui punta pMonitors.
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.
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 |
EnumMonitorsW (Unicode) ed EnumMonitorsA (ANSI) |