SnmpFreePdu-Funktion (winsnmp.h)

Artikel
03/06/2024

[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 SnmpFreePdu-Funktion gibt Ressourcen frei, die einer SNMP-Protokolldateneinheit (PDU) zugeordnet sind, die von snmpCreatePdu oder der SnmpDuplicatePdu-Funktion erstellt wurde.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
  [in] HSNMP_PDU PDU
);

Parameter

[in] PDU

Behandeln Sie die SNMP-PDU, um frei zu werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Um erweiterte Fehlerinformationen abzurufen, rufen Sie SnmpGetLastError auf, indem Sie einen NULL-Wert im Sitzungsparameter angeben. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.

Rückgabecode	Beschreibung
SNMPAPI_NOT_INITIALIZED	Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR	Während der Speicherzuordnung ist ein Fehler aufgetreten.
SNMPAPI_PDU_INVALID	Das PDU-Handle ist ungültig.
SNMPAPI_OTHER_ERROR	Ein unbekannter oder nicht definierter Fehler ist aufgetreten.

Hinweise

Wenn die Anwendung die SnmpClose - oder snmpCleanup-Funktion aufruft, gibt die Microsoft WinSNMP-Implementierung alle Ressourcen frei, die sie für die WinSNMP-Sitzung zugewiesen hat. Es wird jedoch empfohlen, dass die Anwendung einzelne Ressourcen mit der WinSNMP-Funktion freigibt, die der Ressource entspricht. Dies verringert die Arbeitslast der Implementierung und sollte den Dienst der Implementierung für alle Anwendungen verbessern. Die Anwendung sollte die SnmpFreeVbl-Funktion verwenden, um Die Zuordnung von Variablenbindungslistenressourcen zu beheben. Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Concepts.

Unter WinSNMP ist ein Variablenbindungseintrag nur innerhalb einer Variablenbindungsliste vorhanden, auch wenn die Liste der Variablenbindungen nur einen Eintrag enthält.

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