SnmpGetLastError-Funktion (winsnmp.h)

Artikel
08/27/2023

[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die WinSNMP SnmpGetLastError-Funktion gibt den Codewert des letzten Fehlers der aufrufenden Anwendung zurück. Der Wert gibt den Grund an, warum beim letzten Funktionsaufruf, der von der WinSNMP-Anwendung ausgeführt wurde, ein Fehler aufgetreten ist.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
  [in] HSNMP_SESSION session
);

Parameter

[in] session

Handle mit der WinSNMP-Sitzung. Dieser Parameter kann auch NULL sein.

In bestimmten Fällen können Sie bei einem Funktionsaufruf einen NULL-Sitzungswert an die SnmpGetLastError-Funktion übergeben, um den Codewert des letzten Fehlers abzurufen. Dies gilt für Funktionsaufrufe ohne Sitzungsparameter und für Fälle, in denen der Sitzungsparameterwert ungültig ist. Diese Fälle werden im Abschnitt Rückgabewerte auf der Referenzseite der Funktion notiert.

Eine Einzelthreadanwendung kann einen NULL-Sitzungswert an SnmpGetLastError übergeben, um Informationen zum letzten Fehler für die gesamte Anwendung abzurufen.

Weitere Informationen finden Sie in den folgenden Abschnitten "Hinweise" und "Werte zurückgeben".

Rückgabewert

Wenn der Sitzungsparameter ein gültiges WinSNMP-Sitzungshandle ist, gibt die SnmpGetLastError-Funktion den letzten WinSNMP-Fehler zurück, der für die angegebene Sitzung aufgetreten ist.

Wenn der SitzungsparameterNULL ist– wenn beispielsweise die SnmpStartup-Funktion fehlschlägt, gibt SnmpGetLastError den letzten aufgetretenen WinSNMP-Fehler zurück.

Hinweise

Eine WinSNMP-Anwendung muss SnmpGetLastError sofort aufrufen, nachdem eine Funktion fehlschlägt, um den Code des letzten Fehlers abzurufen. Wenn eine andere Funktion fehlschlägt, überschreibt sie den Code des letzten Fehlers, der von der zuletzt fehlgeschlagenen Funktion festgelegt wurde. Weitere Informationen finden Sie unter WinSNMP-Fehlercodes.

Obwohl der Sitzungsparameter sowohl Multithread- als auch Singlethread-Windows-Betriebssystemumgebungen bietet, besteht das Potenzial, dass der letzte Fehlercode aus einem Thread den Code des letzten Fehlers aus einem anderen Thread überschreibt.

Beachten Sie, dass SnmpGetLastError unter den folgenden Bedingungen in der Lage sein muss, den Code des letzten Fehlers an eine WinSNMP-Anwendung zurückzugeben:

Nachdem die SnmpStartup-Funktion fehlschlägt
Bevor die SnmpCreateSession-Funktion WinSNMP-Sitzungen für die instance der Anwendung erstellt
Nachdem die SnmpClose-Funktion alle WinSNMP-Sitzungen für die instance der Anwendung geschlossen hat
Nachdem die SnmpCleanup-Funktion die WinSNMP-Anwendung von der Microsoft WinSNMP-Implementierung getrennt hat

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsnmp.h
Bibliothek	Wsnmp32.lib
DLL	Wsnmp32.dll