Compartir a través de


Función SnmpMgrGetTrapEx (mgmtapi.h)

[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

Consulte también

AsnObjectIdentifier

AsnOctetString

Funciones SNMP

Introducción al Protocolo simple de administración de redes (SNMP)

SnmpMgrTrapListen

SnmpVarBindList