SnmpDeleteVb, 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. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpDeleteVb WinSNMP supprime une entrée de liaison de variable d’une liste de liaisons de variables.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
  [in] HSNMP_VBL vbl,
  [in] smiUINT32 index
);

Paramètres

[in] vbl

Gérez la liste des liaisons de variables à mettre à jour.

[in] index

Spécifie une variable entière longue non signée qui identifie l’entrée de liaison de variable à supprimer. Cette variable contient la position de l’entrée de liaison de variable, dans la liste des liaisons de variables.

Les valeurs valides pour ce paramètre se trouvent dans la plage de 1 à n, où 1 indique la première entrée de liaison de variable dans la liste des liaisons de variables et n est le nombre total d’entrées dans la liste des liaisons de variables. Pour plus d’informations, consultez la section Remarques suivante.

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_INDEX_INVALID	Le paramètre d’index n’est pas valide.
SNMPAPI_VBL_INVALID	Le paramètre vbl n’est pas valide.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

Une application WinSNMP peut utiliser la fonction SnmpDeleteVb pour supprimer des entrées de liaison de variable non valides. Lorsqu’une unité de données de protocole (PDU) de SNMP_PDU_RESPONSE inclut une erreur indiquant une entrée de liaison de variable non valide, l’application peut appeler SnmpDeleteVb pour supprimer l’entrée. Ensuite, l’application peut soumettre à nouveau la requête PDU avec un appel à la fonction SnmpSendMsg , sans l’entrée de liaison de variable non valide dans la liste des liaisons de variables. Les PDU de demande incluent les types de données PDU SNMP_PDU_GET, SNMP_PDU_GETNEXT et SNMP_PDU_GETBULK.

Une fois que la fonction SnmpDeleteVb a supprimé une entrée de liaison de variable, la valeur d’index de toutes les entrées après l’entrée supprimée est décrémentée d’un. Un appel à la fonction SnmpCountVbl retourne le nouveau nombre total d’entrées dans la liste des liaisons de variables. Le nouveau total est inférieur au nombre retourné par un appel à SnmpCountVbl avant l’appel actuel à SnmpDeleteVb.

Si une application WinSNMP appelle la fonction SnmpDeleteVb et supprime la dernière entrée de liaison de variable dans une liste de liaisons de variables, le résultat est une liste de liaisons de variables vide. La liste des liaisons de variables a toujours un handle valide et l’application WinSNMP doit libérer le handle avec un appel à la fonction SnmpFreeVbl .

Les valeurs suivantes sont valides à utiliser pour le paramètre d’index :

Valeur de retour d’un appel à la fonction SnmpCountVbl
Champ d’index d’erreur d’une SNMP_PDU_RESPONSE PDU retourné par un appel à la fonction SnmpRecvMsg

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

Vue d’ensemble de l’API WinSNMP