SnmpGetLastError 函数 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理，这是 WS-Man 的 Microsoft 实现。]
WinSNMP SnmpGetLastError 函数返回调用应用程序的最后错误代码值。 值指示 WinSNMP 应用程序执行的最后一个函数调用失败的原因。
语法
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
[in] HSNMP_SESSION session
);
参数
[in] session
WinSNMP 会话的句柄。 此参数也可以为 NULL。
在某些情况下，当函数调用失败时，可以将 NULL会话 值传递给 SnmpGetLastError 函数以检索最后一个错误代码值。 这适用于不涉及 会话 参数的函数调用，以及 会话 参数值无效的情况。 函数引用页上的“返回值”部分中会记录这些情况。
单线程应用程序可以将 NULL会话 值传递给 SnmpGetLastError ，以检索整个应用程序的最后错误信息。
有关详细信息，请参阅以下备注和返回值部分。
返回值
如果 会话 参数是有效的 WinSNMP 会话句柄， 则 SnmpGetLastError 函数将返回为指示的会话发生的最后一个 WinSNMP 错误。
如果 会话 参数为 NULL ，例如，如果 SnmpStartup 函数失败， SnmpGetLastError 将返回发生的最后一个 WinSNMP 错误。
注解
WinSNMP 应用程序必须在函数失败后立即调用 SnmpGetLastError ，以检索最后一个错误代码。 如果另一个函数失败，它将覆盖最近失败的函数设置的最后一个错误代码。 有关详细信息，请参阅 WinSNMP 错误代码。
尽管 会话 参数同时适用于多线程和单线程 Windows 操作环境，但一个线程中的最后错误代码仍可能覆盖另一个线程的最后错误代码。
请注意，在以下情况下 ，SnmpGetLastError 必须能够将最后一个错误代码返回到 WinSNMP 应用程序：
- SnmpStartup 函数失败后
- SnmpCreateSession 函数为应用程序实例创建任何 WinSNMP 会话之前
- SnmpClose 函数关闭应用程序实例的所有 WinSNMP 会话后
- SnmpCleanup 函数断开 WinSNMP 应用程序与 Microsoft WinSNMP 实现的连接之后
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winsnmp.h |
| Library | Wsnmp32.lib |
| DLL | Wsnmp32.dll |