Fonction SnmpCreateVbl (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 SnmpCreateVbl WinSNMP crée une liste de liaisons de variables pour l’application WinSNMP appelante. Si les paramètres de nom et de valeur ne sont pas NULL, SnmpCreateVbl utilise leurs valeurs pour créer la première entrée de liaison de variable pour la nouvelle liste de liaisons de variables. La fonction SnmpCreateVbl retourne un handle à la nouvelle liste de liaisons de variables et lui alloue toute la mémoire nécessaire.

Syntaxe

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

Paramètres

[in] session

Gérez la session WinSNMP.

[in] name

Pointeur vers une structure smiOID qui contient le nom de la variable pour la première entrée de liaison de variable. Ce paramètre peut être NULL. Pour plus d’informations, consultez la section Remarques suivante.

[in] value

Pointeur vers une structure smiVALUE qui contient une valeur à associer à la variable dans la première entrée de liaison de variable. Ce paramètre peut être NULL. Pour plus d’informations, consultez la section Remarques suivante.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle vers une nouvelle liste de liaisons de variables.

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_SESSION_INVALID	Le handle de session n’est pas valide.
SNMPAPI_OID_INVALID	Le paramètre name fait référence à une structure smiOID non valide.
SNMPAPI_SYNTAX_INVALID	Le membre de syntaxe de la structure pointée vers le paramètre value n’est pas valide.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

La fonction SnmpCreateVbl utilise les valeurs des paramètres name et value pour créer et initialiser la première entrée de liaison de variable d’une nouvelle liste de liaisons de variables. Si le paramètre name a la valeur NULL, l’implémentation de Microsoft WinSNMP ignore le paramètre value et crée une liste de liaisons de variables vide.

Si le paramètre name n’est pas NULL, mais que le paramètre value a la valeur NULL, l’implémentation crée et initialise la première entrée de liaison de variable dans la liste des liaisons de variables. Il initialise le membre de syntaxe de la structure pointée vers le paramètre value avec la valeur SNMP_SYNTAX_NULL.

L’application WinSNMP doit libérer les ressources associées à chaque liste de liaisons de variables. Pour ce faire, il doit faire correspondre chaque appel aux fonctions SnmpCreateVbl et SnmpDuplicateVbl avec un appel correspondant à la fonction SnmpFreeVbl . Pour éviter les fuites de mémoire, une application WinSNMP doit appeler SnmpFreeVbl avant de réutiliser le handle dans une liste de liaisons de variables dans un appel ultérieur à SnmpCreateVbl ou SnmpDuplicateVbl. Pour plus d’informations, consultez Concepts de Gestion des données WinSNMP.

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