Función SnmpFreePdu (winsnmp.h)
[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 SnmpFreePdu de WinSNMP libera los recursos asociados a una unidad de datos del protocolo SNMP (PDU) creada por snmpCreatePdu o la función SnmpDuplicatePdu .
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
Parámetros
[in] PDU
Controle el PDU snmp para liberarlo.
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 |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El identificador PDU no es válido. |
|
Se produjo un error desconocido o no definido. |
Comentarios
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, se recomienda que la aplicación libere recursos individuales con la función WinSNMP que corresponde al recurso. Esto reduce la carga de trabajo de la implementación y debe mejorar el servicio de la implementación para todas las aplicaciones. La aplicación debe usar la función SnmpFreeVbl para desasignar los recursos de lista de enlaces de variables. Para obtener más información, consulte Conceptos de winSNMP Administración de datos.
En WinSNMP, una entrada de enlace de variable solo existe dentro de una lista de enlaces de variables, incluso si la lista de enlaces de variables contiene solo una entrada.
Requisitos
| Requisito | Value |
|---|---|
| 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 |