Función SnmpExtensionInit (snmp.h)

Artículo
03/15/2023

[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

El servicio SNMP de Microsoft llama a la función SnmpExtensionInit para inicializar el archivo DLL del agente de extensión SNMP. Esta función es un elemento de la API del Agente de extensión SNMP.

Sintaxis

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

Parámetros

[in] dwUptimeReference

Especifica una referencia de tiempo cero para el agente de extensión.

Nota Los agentes de extensión deben omitir este parámetro. El archivo DLL del agente de extensión SNMP debe usar la función SnmpSvcGetUptime para recuperar el número de centisegundos que el servicio SNMP ha estado ejecutando. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[out] phSubagentTrapEvent

Puntero a un controlador de eventos que controla el agente de extensión pasa al servicio SNMP. Este identificador se usa para notificar al servicio que el agente de extensión tiene una o varias capturas que se van a enviar. Para obtener información adicional sobre cómo asignar y desasignar el identificador de eventos, consulte la siguiente sección Comentarios.

[out] pFirstSupportedRegion

Puntero a una estructura AsnObjectIdentifier para recibir el primer subárbol MIB que admite el agente de extensión. Para obtener información adicional sobre cómo asignar y desasignar recursos para esta estructura, consulte la sección Comentarios siguiente.

El agente de extensión puede registrar subárboles MIB adicionales mediante la implementación de la función de punto de entrada SnmpEx .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE.

Comentarios

Los agentes de extensión deben omitir el parámetro dwUptimeReference . En su lugar, deben llamar a la función SnmpSvcGetUptime para recuperar el número de centisegundos que el servicio SNMP de Microsoft ha estado ejecutando. Dado que el parámetro dwUptimeReference almacena el tiempo transcurrido como un valor DWORD en milisegundos, el tiempo puede encapsularse en cero y reflejar un intervalo de tiempo inexacto.

El agente de extensión notifica al servicio SNMP que necesita enviar una o varias capturas estableciendo el identificador de eventos pasado en el parámetro phSubagentTrapEvent al estado señalado. Una vez señalado este evento, el servicio SNMP llama repetidamente al punto de entrada SnmpExtensionTrap del agente de extensión hasta que la función devuelve un valor false. Esto indica que el agente de extensión no tiene más capturas que enviar. Si el agente de extensión no genera capturas, el parámetro phSubagentTrapEvent debe devolver un valor null.

El agente de extensión SNMP debe asignar y desasignar recursos para el identificador de eventos de captura. Cuando el servicio SNMP llama a la función SnmpExtensionInit , el agente de extensión debe llamar a la función CreateEvent para asignar el identificador de eventos. El agente de extensión pasa el identificador al servicio SNMP en el parámetro phSubagentTrapEvent . Cuando el servicio SNMP llama a la función SnmpExtensionClose , el agente de extensión debe desasignar los recursos para el identificador de eventos de captura.

El servicio SNMP realiza una copia de la estructura AsnObjectIdentifier que el agente de extensión devuelve en el parámetro pFirstSupportedRegion . El agente de extensión debe asignar y desasignar los recursos asociados a la estructura original. Puede hacerlo cuando el servicio SNMP llama a la función SnmpExtensionClose .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	snmp.h