Funzione SnmpExtensionMonitor (snmp.h)

Articolo
03/02/2024

[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