SnmpSetVb, fonction (winsnmp.h)

[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 SnmpSetVb WinSNMP modifie les entrées de liaison de variable dans une liste de liaisons de variables. Cette fonction ajoute également de nouvelles entrées de liaison de variable à une liste de liaisons de variables existante.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
  [in] HSNMP_VBL   vbl,
  [in] smiUINT32   index,
  [in] smiLPCOID   name,
  [in] smiLPCVALUE value
);

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 contient la position de l’entrée de liaison de variable, dans la liste des liaisons de variable, s’il s’agit d’une opération de mise à jour. S’il s’agit d’une opération d’ajout, ce paramètre doit être égal à zéro. Pour plus d'informations, consultez la section Notes qui suit.

[in] name

Pointeur vers une structure smiOID qui représente le nom de la variable à ajouter ou à modifier. Pour plus d'informations, consultez la section Notes qui suit.

[in] value

Pointeur vers une structure smiVALUE . La structure contient la valeur associée à la variable spécifiée par le paramètre name .

Valeur retournée

Si la fonction réussit, la valeur de retour correspond à la position de l’entrée de liaison de variable mise à jour ou ajoutée dans la liste des liaisons de variables. Pour plus d’informations, consultez la section Remarques suivante.

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_VBL_INVALID	Le paramètre vbl n’est pas valide.
SNMPAPI_INDEX_INVALID	Le paramètre d’index n’est pas valide.
SNMPAPI_OID_INVALID	Le paramètre name n’est pas valide.
SNMPAPI_SYNTAX_INVALID	Le membre de syntaxe de la structure vers laquelle pointe le paramètre value n’est pas valide.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

Les valeurs valides pour le paramètre d’index vont de zéro à n. La valeur zéro indique une opération d’ajout. La valeur n est le nombre total d’entrées de liaison de variable dans la liste des liaisons de variables. Une application WinSNMP doit appeler la fonction SnmpCountVbl avant d’appeler SnmpSetVb pour obtenir le nombre total d’entrées de liaison de variable.

Si la fonction effectue correctement une opération de mise à jour, la valeur de retour est égale à la valeur du paramètre d’index . Si la fonction ajoute une entrée de liaison de variable, la valeur de retour est n + 1.

Si le paramètre name n’est pas NULL, mais que le paramètre value a la valeur NULL, l’implémentation de Microsoft WinSNMP initialise la nouvelle entrée de liaison de variable avec le membre value défini sur NULL et avec le membre de syntaxe défini sur SNMP_SYNTAX_.

Si le paramètre d’index n’est pas égal à zéro et que le paramètre name a la valeur NULL, l’implémentation de Microsoft WinSNMP met à jour uniquement la valeur de la variable pointée par le paramètre d’index .

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

SnmpCountVbl

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP

smiOID

smiVALUE