SnmpSetPduData, fonction (winsnmp.h)

Article
08/27/2023

[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpSetPduData WinSNMP met à jour les champs de données sélectionnés dans l’unité de données de protocole SNMP (PDU) spécifiée.

Syntaxe

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
);

Paramètres

[in] PDU

Handle vers un PDU SNMP.

[in] PDU_type

Pointeur vers une variable avec une valeur pour mettre à jour le champ PDU_type de la PDU spécifiée. Ce paramètre peut également être NULL.

[in] request_id

Pointeur vers une variable avec une valeur pour mettre à jour le champ request_id de la PDU spécifiée. Ce paramètre peut également être NULL.

[in] non_repeaters

Si le paramètre PDU_type est égal à SNMP_PDU_GETBULK, ce paramètre pointe vers une variable avec une valeur pour mettre à jour le champ non_repeaters de la PDU spécifiée. L’implémentation De Microsoft WinSNMP ignore ce paramètre pour les autres types de PDU. Ce paramètre peut également être NULL.

[in] max_repetitions

Si le paramètre PDU_type est égal à SNMP_PDU_GETBULK, ce paramètre pointe vers une variable avec une valeur pour mettre à jour le champ max_repetitions de la PDU spécifiée. L’implémentation ignore ce paramètre pour d’autres types PDU. Ce paramètre peut également être NULL.

[in] varbindlist

Pointeur vers une variable avec une valeur qui met à jour le handle vers le champ de liste des liaisons de variables de la PDU spécifiée. Ce paramètre peut également être NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est SNMPAPI_SUCCESS.

Si la fonction échoue, la valeur de retour est SNMPAPI_FAILURE. Pour obtenir des informations d’erreur étendues, appelez SnmpGetLastError. La fonction SnmpGetLastError peut retourner l’une des erreurs suivantes.

Code de retour	Description
SNMPAPI_NOT_INITIALIZED	La fonction SnmpStartup ne s’est pas terminée correctement.
SNMPAPI_ALLOC_ERROR	Une erreur s’est produite lors de l’allocation de mémoire.
SNMPAPI_PDU_INVALID	Le type PDU n’est pas valide.
SNMPAPI_VBL_INVALID	La liste des liaisons de variables n’est pas valide.
SNMPAPI_NOOP	Tous les paramètres d’entrée sont NULL. L’opération SNMP n’a pas été effectuée.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

Tous les paramètres de la fonction SnmpSetPduData sont obligatoires. Toutefois, tous les paramètres, à l’exception du paramètre PDU , peuvent être NULL. Si l’application WinSNMP transmet NULL dans un paramètre, SnmpSetPduData ne met pas à jour le champ correspondant dans la PDU. Étant donné que SnmpSetPduData transmet des paramètres en tant que pointeurs vers des valeurs, une application peut toujours mettre à jour un champ PDU avec NULL.

La valeur d’un champ PDU peut être valide seule, mais peut être invalidée en combinaison avec les valeurs d’autres champs. L’implémentation valide la PDU et les autres éléments de message lorsque l’application appelle les fonctions SnmpSendMsg ou SnmpEncodeMsg . L’implémentation rejette les PPU non valides.

Le seul type de PDU d’interruption que vous pouvez mettre à jour avec un appel à la fonction SnmpSetPduData est une PDU d’interruption SNMPv2C.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsnmp.h
Bibliothèque	Wsnmp32.lib
DLL	Wsnmp32.dll

Voir aussi

SnmpEncodeMsg

SnmpSendMsg

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP