Función SnmpFreeVbl (winsnmp.h)

Artículo
08/27/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 administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpFreeVbl de WinSNMP libera los recursos asociados a una lista de enlaces de variables. Estos son recursos asignados anteriormente mediante una llamada a la función SnmpCreateVbl o a la función SnmpDuplicateVbl en una aplicación WinSNMP.

Sintaxis

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

Parámetros

[in] vbl

Identificador de la lista de enlaces de variables que se va a liberar.

Valor devuelto

Si la función se realiza correctamente, se SNMPAPI_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto se SNMPAPI_FAILURE. Para obtener información de error extendida, llame a SnmpGetLastError especificando un valor NULL en su parámetro de sesión . 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_VBL_INVALID	El parámetro vbl no es válido.
SNMPAPI_OTHER_ERROR	Se produjo un error desconocido o no definido.

Comentarios

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.

Si la aplicación llama a SnmpClose o a la función SnmpCleanup , la implementación de Microsoft WinSNMP libera todos los recursos que asigna para la sesión de WinSNMP. Sin embargo, incluso si la aplicación no reutiliza un identificador de lista de enlaces de variables, se recomienda que la aplicación libere recursos de enlaces de variables individuales con la función SnmpFreeVbl . Esto reduce la carga de trabajo de la implementación y debe mejorar su servicio para todas las aplicaciones. Para obtener más información, consulte Conceptos de winSNMP Administración de datos.

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