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 |
|---|---|
|
La fonction SnmpStartup ne s’est pas terminée correctement. |
|
Une erreur s’est produite lors de l’allocation de mémoire. |
|
Le paramètre vbl n’est pas valide. |
|
Le paramètre d’index n’est pas valide. |
|
Le paramètre name n’est pas valide. |
|
Le membre de syntaxe de la structure vers laquelle pointe le paramètre value n’est pas valide. |
|
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 |