Funzione SnmpExtensionInit (snmp.h)

Articolo
03/15/2023

[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 SnmpExtensionInit per inizializzare la DLL dell'agente di estensione SNMP. Questa funzione è un elemento dell'API dell'agente di estensione SNMP.

Sintassi

BOOL SNMP_FUNC_TYPE SnmpExtensionInit(
  [in]  DWORD               dwUptimeReference,
  [out] HANDLE              *phSubagentTrapEvent,
  [out] AsnObjectIdentifier *pFirstSupportedRegion
);

Parametri

[in] dwUptimeReference

Specifica un riferimento time-zero per l'agente di estensione.

Nota Gli agenti di estensione devono ignorare questo parametro. La DLL dell'agente di estensione SNMP deve usare la funzione SnmpSvcGetUptime per recuperare il numero di centisecondi in cui è stato eseguito il servizio SNMP. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[out] phSubagentTrapEvent

Puntatore a un gestore eventi dell'agente di estensione passa nuovamente al servizio SNMP. Questo handle viene usato per notificare al servizio che l'agente di estensione ha una o più trap da inviare. Per altre informazioni sull'allocazione e la deallocazione dell'handle eventi, vedere la sezione Note seguenti.

[out] pFirstSupportedRegion

Puntatore a una struttura AsnObjectIdentifier per ricevere il primo sottoalbero MIB supportato dall'agente di estensione. Per altre informazioni sull'allocazione e la deallocazione delle risorse per questa struttura, vedere la sezione Note seguenti.

L'agente di estensione può registrare sottoalberi MIB aggiuntivi implementando la funzione punto di ingresso SnmpExtensionInitEx .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE.

Commenti

Gli agenti di estensione devono ignorare il parametro dwUptimeReference . Devono invece chiamare la funzione SnmpSvcGetUptime per recuperare il numero di centisecondi in cui è stato eseguito il servizio Microsoft SNMP. Poiché il parametro dwUptimeReference archivia il tempo trascorso come valore DWORD in millisecondi, il tempo può eseguire il wrapping su zero e riflettere un intervallo di tempo non accurato.

L'agente di estensione notifica al servizio SNMP che deve inviare una o più trap impostando l'handle eventi passato nel parametro phSubagentTrapEvent allo stato segnalato. Dopo aver segnalato questo evento, il servizio SNMP chiama ripetutamente il punto di ingresso SnmpExtensionTrap dell'agente di estensione fino a quando la funzione restituisce un valore false. Ciò indica che l'agente di estensione non ha più trap da inviare. Se l'agente di estensione non genera trap, il parametro phSubagentTrapEvent deve restituire un valore NULL.

L'agente di estensione SNMP deve allocare e deallocare le risorse per l'handle eventi trap. Quando il servizio SNMP chiama la funzione SnmpExtensionInit , l'agente di estensione deve chiamare la funzione CreateEvent per allocare l'handle eventi. L'agente di estensione passa l'handle al servizio SNMP nel parametro phSubagentTrapEvent . Quando il servizio SNMP chiama la funzione SnmpExtensionClose , l'agente di estensione deve deallocare le risorse per l'handle eventi trap.

Il servizio SNMP esegue una copia della struttura AsnObjectIdentifier restituita nel parametro pFirstSupportedRegion . L'agente di estensione deve allocare e deallocare le risorse associate alla struttura originale. Può eseguire questa operazione quando il servizio SNMP chiama la funzione SnmpExtensionClose .

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