Funzione SnmpExtensionMonitor (snmp.h)
[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.
Il servizio Microsoft SNMP chiama la funzione SnmpExtensionMonitor per fornire all'agente di estensione SNMP una visualizzazione ai contatori e ai parametri interni del servizio. Questa funzione è un elemento dell'API dell'agente di estensione SNMP.
La funzione SnmpExtensionMonitor è facoltativa. Gli agenti di estensione devono implementare la funzione se sono interessati a una visualizzazione degli oggetti di gestione interni del servizio SNMP, come definito in RFC 1213, "Management Information Base for Network Management of TCP/IP-based Internets: MIB-II".
Sintassi
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
[in] LPVOID pAgentMgmtData
);
Parametri
[in] pAgentMgmtData
Puntatore a una matrice di oggetti AsnAny (strutture). Il numero di oggetti e il tipo e la descrizione di ogni oggetto sono conformi a RFC 1213. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
A meno che non si verifichi un errore imprevisto mentre l'agente di estensione SNMP elabora il valore del parametro pAgentMgmtData , l'agente di estensione deve restituire TRUE. Se l'agente di estensione restituisce FALSE, il servizio SNMP non carica l'agente di estensione e il servizio interrompe l'indirizzamento delle richieste SNMP all'agente di estensione.
Commenti
Se l'agente di estensione esporta la funzione SnmpExtensionMonitor , il servizio SNMP chiama la funzione durante l'inizializzazione dell'agente di estensione, subito dopo che il servizio chiama snmpExtensionInit e le funzioni SnmpExtensionInitEx .
Il servizio SNMP aggiorna dinamicamente i contatori SNMP (ad esempio, snmpInPkts e i contatori snmpOutNoSuchNames) nella matrice a cui punta il parametro pAgentMgmtData . Per poter leggere questi valori durante l'esecuzione del servizio SNMP, l'agente di estensione deve archiviare il puntatore a pAgentMgmtData.
Si noti che un agente di estensione SNMP non deve aggiornare la memoria a cui punta il parametro pAgentMgmtData . Ciò è dovuto al fatto che i valori dei contatori interni del servizio SNMP non sarebbero più validi e il comportamento del servizio SNMP potrebbe diventare imprevedibile. Purché l'agente di estensione non lo modifichi, la memoria a cui punta pAgentMgmtData è valida durante l'esecuzione del servizio SNMP.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | snmp.h |
Vedi anche
Panoramica del protocollo Simple Network Management Protocol (SNMP)