Función SnmpMgrGetTrapEx (mgmtapi.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 la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpMgrGetTrapEx devuelve datos de captura pendientes que el autor de la llamada no ha recibido si está habilitada la recepción de capturas. Además de la información devuelta por la función SnmpMgrGetTrap , esta función extendida devuelve la dirección del origen de transporte y la cadena de comunidad de la captura. Esta función es un elemento de la API de administración de SNMP.

Sintaxis

BOOL SNMP_FUNC_TYPE SnmpMgrGetTrapEx(
  [out] AsnObjectIdentifier *enterprise,
  [out] AsnNetworkAddress   *agentAddress,
  [out] AsnNetworkAddress   *sourceAddress,
  [out] AsnInteger          *genericTrap,
  [out] AsnInteger          *specificTrap,
  [out] AsnOctetString      *community,
  [out] AsnTimeticks        *timeStamp,
  [out] RFC1157VarBindList  *variableBindings
);

Parámetros

[out] enterprise

Puntero a una estructura AsnObjectIdentifier para recibir la empresa que generó la captura snmp.

[out] agentAddress

Puntero a una variable para recibir la dirección del agente que generó la captura snmp; esta información se recupera de la unidad de datos del protocolo SNMP (PDU).

[out] sourceAddress

Puntero a una variable para recibir la dirección del agente que generó la captura snmp; esta información se recupera del transporte de red.

[out] genericTrap

Puntero a una variable para recibir un indicador de la captura genérica. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
SNMP_GENERICTRAP_COLDSTART	El agente está inicializando entidades de protocolo en el modo administrado. Puede modificar objetos en su vista.
SNMP_GENERICTRAP_WARMSTART	El agente se reinicializa, pero no modificará los objetos en su vista.
SNMP_GENERICTRAP_LINKDOWN	Una interfaz adjunta ha cambiado del estado ascendente al estado inactivo. La primera variable de la lista de enlaces de variables identifica la interfaz .
SNMP_GENERICTRAP_LINKUP	Una interfaz adjunta ha cambiado del estado descendente al estado ascendente. La primera variable de la lista de enlaces de variables identifica la interfaz .
SNMP_GENERICTRAP_AUTHFAILURE	Una entidad SNMP ha enviado un mensaje SNMP, pero se ha reclamado falsamente que pertenezca a una comunidad conocida.
SNMP_GENERICTRAP_EGPNEIGHLOSS	Un par EGP ha cambiado al estado inactivo. La primera variable de la lista de enlaces de variables identifica la dirección IP del par EGP.
SNMP_GENERICTRAP_ENTERSPECIFIC	Se ha producido un evento extraordinario. Se identifica en el parámetro specificTrap con un valor específico de la empresa.

[out] specificTrap

Puntero a una variable para recibir un indicador de la captura específica generada.

[out] community

Puntero a una estructura AsnOctetString para recibir la cadena de comunidad de la captura snmp generada.

[out] timeStamp

Puntero a una variable para recibir la marca de tiempo.

[out] variableBindings

Puntero a una estructura SnmpVarBindList para recibir la lista de enlaces de variables.

Valor devuelto

Si la función devuelve una captura, el valor devuelto es distinto de cero.

Debe llamar a la función SnmpMgrGetTrapEx repetidamente hasta que devuelva cero. La función también puede devolver los siguientes códigos de error.

Código devuelto	Descripción
SNMP_MGMTAPI_TRAP_ERRORS	Indica que se encontraron errores; Las trampas no son accesibles.
SNMP_MGMTAPI_NOTRAPS	Indica que no hay capturas disponibles.
SNMP_MEM_ALLOC_ERROR	Indica un error de asignación de memoria.

Comentarios

La aplicación siempre debe llamar a la función SnmpMgrTrapListen antes de llamar a la función SnmpMgrGetTrapEx . Esto se debe a que el controlador de eventos al que apunta el parámetro phTrapAvailable de la función SnmpMgrTrapListen habilita la adquisición controlada por eventos de capturas SNMP. SNMP Management API indica un evento de aplicación cuando el servicio de captura de SNMP entrega una captura.

La aplicación también puede sondear la función SnmpMgrGetTrapEx para detectar capturas a intervalos regulares. En este caso, la aplicación debe llamar repetidamente a SnmpMgrGetTrapEx hasta que la función devuelva cero.

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	mgmtapi.h
Library	Mgmtapi.lib
Archivo DLL	Mgmtapi.dll