Función SnmpSetPduData (winsnmp.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 SnmpSetPduData de WinSNMP actualiza los campos de datos seleccionados en la unidad de datos del protocolo SNMP (PDU) especificado.

Sintaxis

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetPduData(
  [in] HSNMP_PDU       PDU,
  [in] const smiINT    *PDU_type,
  [in] const smiINT32  *request_id,
  [in] const smiINT    *non_repeaters,
  [in] const smiINT    *max_repetitions,
  [in] const HSNMP_VBL *varbindlist
);

Parámetros

[in] PDU

Identificador de un PDU snmp.

[in] PDU_type

Puntero a una variable con un valor para actualizar el campo PDU_type de la PDU especificada. Este parámetro también puede ser NULL.

[in] request_id

Puntero a una variable con un valor para actualizar el campo request_id de la PDU especificada. Este parámetro también puede ser NULL.

[in] non_repeaters

Si el parámetro PDU_type es igual a SNMP_PDU_GETBULK, este parámetro apunta a una variable con un valor para actualizar el campo non_repeaters de la PDU especificada. La implementación de Microsoft WinSNMP omite este parámetro para otros tipos de PDU. Este parámetro también puede ser NULL.

[in] max_repetitions

Si el parámetro PDU_type es igual a SNMP_PDU_GETBULK, este parámetro apunta a una variable con un valor para actualizar el campo max_repetitions de la PDU especificada. La implementación omite este parámetro para otros tipos de PDU. Este parámetro también puede ser NULL.

[in] varbindlist

Puntero a una variable con un valor que actualiza el identificador al campo de lista enlaces de variables del PDU especificado. Este parámetro también puede ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es SNMPAPI_SUCCESS.

Si se produce un error en la función, el valor devuelto es SNMPAPI_FAILURE. Para obtener información de error extendida, llame a SnmpGetLastError. La función SnmpGetLastError puede devolver uno de los siguientes errores.

Código devuelto	Descripción
SNMPAPI_NOT_INITIALIZED	La función SnmpStartup no se completó correctamente.
SNMPAPI_ALLOC_ERROR	Error durante la asignación de memoria.
SNMPAPI_PDU_INVALID	El tipo PDU no es válido.
SNMPAPI_VBL_INVALID	La lista de enlaces de variables no es válida.
SNMPAPI_NOOP	Todos los parámetros de entrada son NULL. No se realizó la operación SNMP.
SNMPAPI_OTHER_ERROR	Error desconocido o indefinido.

Comentarios

Se requieren todos los parámetros de la función SnmpSetPduData . Sin embargo, todos los parámetros, excepto el parámetro PDU , pueden ser NULL. Si la aplicación WinSNMP pasa NULL en un parámetro, SnmpSetPduData no actualiza el campo correspondiente en la PDU. Dado que SnmpSetPduData pasa parámetros como punteros a valores, una aplicación todavía puede actualizar un campo PDU con NULL.

El valor de un campo PDU puede ser válido solo, pero se puede invalidar en combinación con valores para otros campos. La implementación valida la PDU y los demás elementos de mensaje cuando la aplicación llama a las funciones SnmpSendMsg o SnmpEncodeMsg . La implementación rechaza las PDU no válidas.

El único tipo de PDU de captura que puede actualizar con una llamada a la función SnmpSetPduData es una PDU de captura de SNMPv2C.

Requisitos

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	winsnmp.h
Library	Wsnmp32.lib
Archivo DLL	Wsnmp32.dll

Consulte también

SnmpEncodeMsg

SnmpSendMsg

Funciones winSNMP

Introducción a la API de WinSNMP