Funzione AddMonitor

La funzione AddMonitor installa un monitoraggio della porta locale e collega i file di configurazione, dati e monitoraggio.

Sintassi

BOOL AddMonitor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pMonitors
);

Parametri

pName [in]

Puntatore a una stringa con terminazione null che specifica il nome del server in cui deve essere installato il monitoraggio. Per i sistemi che supportano solo l'installazione locale dei monitoraggi, questa stringa deve essere NULL.

Livello [in]

Versione della struttura a cui pMonitors punta. Questo valore deve essere 2.

pMonitors [in]

Puntatore a una struttura MONITOR_INFO_2 . Se il membro pEnvironment della struttura pMonitors è NULL, viene usato l'ambiente corrente del chiamante (client), non della destinazione (server).

Si noti che la chiamata avrà esito negativo se l'ambiente non corrisponde all'ambiente del server, ovvero è possibile aggiungere solo un monitoraggio scritto per l'architettura del server.

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.

Il chiamante deve avere SeLoadDriverPrivilege.

Prima che un'applicazione chiami la funzione AddMonitor , tutti i file richiesti dal monitoraggio devono essere copiati nella directory SYSTEM32.

Per determinare i monitoraggi delle porte attualmente installati, chiamare la funzione EnumMonitors .

Per rimuovere un monitoraggio aggiunto da AddMonitor, chiamare la funzione DeleteMonitor .

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	AddMonitorW (Unicode) e AddMonitorA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

DeleteMonitor

EnumMonitors

MONITOR_INFO_2