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	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	EnumMonitorsW (Unicode) ed EnumMonitorsA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

MONITOR_INFO_1

MONITOR_INFO_2