Función SnmpCreateVbl (winsnmp.h)

Artículo
03/15/2023

[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpCreateVbl de WinSNMP crea una nueva lista de enlaces de variables para la aplicación WinSNMP que llama. Si los parámetros name y value no son NULL, SnmpCreateVbl usa sus valores para crear la primera entrada de enlace de variable para la nueva lista de enlaces de variables. La función SnmpCreateVbl devuelve un identificador a la nueva lista de enlaces de variables y asigna cualquier memoria necesaria para ella.

Sintaxis

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

Parámetros

[in] session

Controle la sesión de WinSNMP.

[in] name

Puntero a una estructura smiOID que contiene el nombre de la variable para la primera entrada de enlace de variable. Este parámetro puede ser NULL. Para obtener más información, vea la siguiente sección Comentarios.

[in] value

Puntero a una estructura smiVALUE que contiene un valor que se va a asociar a la variable en la primera entrada de enlace de variable. Este parámetro puede ser NULL. Para obtener más información, vea la siguiente sección Comentarios.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para una nueva lista de enlaces de variables.

Si se produce un error en la función, el valor devuelto es SNMPAPI_FAILURE. Para obtener información de error extendida, llame a SnmpGetLastError. La función SnmpGetLastError puede devolver uno de los siguientes errores.

Código devuelto	Descripción
SNMPAPI_NOT_INITIALIZED	La función SnmpStartup no se completó correctamente.
SNMPAPI_ALLOC_ERROR	Error durante la asignación de memoria.
SNMPAPI_SESSION_INVALID	El identificador de sesión no es válido.
SNMPAPI_OID_INVALID	El parámetro name hace referencia a una estructura smiOID no válida.
SNMPAPI_SYNTAX_INVALID	El miembro de sintaxis de la estructura a la que apunta el parámetro value no es válido.
SNMPAPI_OTHER_ERROR	Error desconocido o indefinido.

Comentarios

La función SnmpCreateVbl usa los valores de los parámetros name y value para crear e inicializar la primera entrada de enlace de variable de una nueva lista de enlaces de variables. Si el parámetro name es NULL, la implementación de Microsoft WinSNMP omite el parámetro value y crea una lista de enlaces de variables vacías.

Si el parámetro name no es NULL, pero el parámetro value es NULL, la implementación crea e inicializa la primera entrada de enlace de variable en la lista de enlaces de variables. Inicializa el miembro de sintaxis de la estructura a la que apunta el parámetro value con el valor SNMP_SYNTAX_NULL.

La aplicación WinSNMP debe liberar los recursos asociados a cada lista de enlaces de variables. Para ello, debe hacer coincidir cada llamada a las funciones SnmpCreateVbl y SnmpDuplicateVbl con una llamada correspondiente a la función SnmpFreeVbl . Para evitar pérdidas de memoria, una aplicación WinSNMP debe llamar a SnmpFreeVbl antes de reutilizar el identificador en una lista de enlaces de variables en una llamada posterior a SnmpCreateVbl o SnmpDuplicateVbl. Para obtener más información, consulte Conceptos de Administración de datos de WinSNMP.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winsnmp.h
Library	Wsnmp32.lib
Archivo DLL	Wsnmp32.dll