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