Función SnmpMgrRequest (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 SnmpMgrRequest solicita que se realice la operación especificada con el agente especificado. Esta función es un elemento de la API de administración de SNMP.

Sintaxis

SNMPAPI SNMP_FUNC_TYPE SnmpMgrRequest(
  [in]      LPSNMP_MGR_SESSION session,
  [in]      BYTE               requestType,
  [in, out] RFC1157VarBindList *variableBindings,
  [out]     AsnInteger         *errorStatus,
  [out]     AsnInteger         *errorIndex
);

Parámetros

[in] session

Puntero a una estructura interna que especifica la sesión que realizará la solicitud.

Las aplicaciones no deben especificar el puntero LPSNMP_MGR_SESSION devuelto por esta función en un subproceso diferente. Puede especificar un puntero devuelto por SnmpMgrOpen, pero solo si las llamadas a SnmpMgrOpen y SnmpMgrRequest se originan en el contexto del mismo subproceso.

[in] requestType

Especifica el tipo de solicitud SNMP. Este parámetro puede ser uno de los siguientes valores definidos por SNMPv1.

Valor	Significado
SNMP_PDU_GET	Recupere el valor o los valores de las variables especificadas.
SNMP_PDU_GETNEXT	Recupere el valor o los valores del sucesor lexicográfico de la variable especificada.
SNMP_PDU_SET	Escriba un valor dentro de una variable específica.

 

Tenga en cuenta que se ha cambiado el nombre de los tipos de solicitud PDU. Para obtener más información, vea Tipos de variables SNMP y Tipos PDU de solicitud.

[in, out] variableBindings

Puntero a la lista de enlaces de variables.

Nota La matriz SnmpVarBind a la que apunta la estructura SnmpVarBindList debe asignarse mediante la función SnmpUtilMemAlloc .

 

[out] errorStatus

Puntero a una variable en la que se devolverá el resultado del estado del error. Este parámetro puede ser uno de los siguientes valores definidos por SNMPv1.

Valor	Significado
SNMP_ERRORSTATUS_NOERROR	El agente informa de que no se produjeron errores durante la transmisión.
SNMP_ERRORSTATUS_TOOBIG	El agente no pudo colocar los resultados de la operación solicitada en un único mensaje SNMP.
SNMP_ERRORSTATUS_NOSUCHNAME	La operación solicitada identificó una variable desconocida.
SNMP_ERRORSTATUS_BADVALUE	La operación solicitada intentó cambiar una variable, pero especificó un error de sintaxis o valor.
SNMP_ERRORSTATUS_READONLY	La operación solicitada intentó cambiar una variable que no se permitía cambiar según el perfil de comunidad de la variable.
SNMP_ERRORSTATUS_GENERR	Error distinto de uno de los enumerados aquí durante la operación solicitada.

[out] errorIndex

Puntero a una variable en la que se devolverá el resultado del índice de error.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError, que puede devolver uno de los siguientes códigos de error.

Código devuelto	Descripción
SNMP_MGMTAPI_TIMEOUT	Se agota el tiempo de espera de la solicitud.
SNMP_MGMTAPI_SELECT_FDERRORS	Descriptores de archivo de error inesperados indicados por la función select de Windows Sockets.

Comentarios

Los reintentos y los tiempos de espera se proporcionan a la función SnmpMgrOpen . Cada variable de la lista de enlaces de variables debe inicializarse para escribir ASN_NULL para las solicitudes Get y Get Next.

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

Funciones SNMP

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

SnmpMgrClose

SnmpMgrOpen