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 應用程式：

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winsnmp.h
程式庫	Wsnmp32.lib
Dll	Wsnmp32.dll