Función SnmpGetLastError (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 SnmpGetLastError de WinSNMP devuelve el valor de código de último error de la aplicación que realiza la llamada. El valor indica el motivo por el que se produjo un error en la última llamada de función ejecutada por la aplicación WinSNMP.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
[in] HSNMP_SESSION session
);
Parámetros
[in] session
Controla la sesión de WinSNMP. Este parámetro también puede ser NULL.
En algunos casos, cuando se produce un error en una llamada de función, puede pasar un valor de sesiónNULL a la función SnmpGetLastError para recuperar el último valor de código de error. Esto se aplica a las llamadas de función que no implican un parámetro de sesión y los casos en los que el valor del parámetro de sesión no es válido. Estos casos se indican en la sección Valores devueltos de la página de referencia de la función.
Una aplicación de un solo subproceso puede pasar un valor de sesiónNULL a SnmpGetLastError para recuperar la información del último error de toda la aplicación.
Para obtener más información, vea las secciones Comentarios y Valores devueltos siguientes.
Valor devuelto
Si el parámetro de sesión es un identificador de sesión winSNMP válido, la función SnmpGetLastError devuelve el último error de WinSNMP que se produjo para la sesión indicada.
Si el parámetro de sesión es NULL , por ejemplo, si se produce un error en la función SnmpStartup , SnmpGetLastError devuelve el último error winSNMP que se produjo.
Comentarios
Una aplicación WinSNMP debe llamar a SnmpGetLastError inmediatamente después de que se produzca un error en una función para recuperar el último código de error. Si se produce un error en otra función, sobrescribe el último código de error establecido por la función con errores más reciente. Para obtener más información, consulte Códigos de error de WinSNMP.
Aunque el parámetro de sesión admite entornos operativos Windows de varios subprocesos y multiproceso, el potencial sigue existiendo para el último código de error de un subproceso para sobrescribir el último código de error de otro subproceso.
Tenga en cuenta que SnmpGetLastError debe poder devolver el último código de error a una aplicación WinSNMP en las siguientes condiciones:
- Después de que se produzca un error en la función SnmpStartup
- Antes de que la función SnmpCreateSession cree cualquier sesión winSNMP para la instancia de la aplicación
- Después de que la función SnmpClose cierre todas las sesiones de WinSNMP para la instancia de la aplicación
- Después de que la función SnmpCleanup desconecte la aplicación WinSNMP de la implementación de Microsoft WinSNMP
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 |