SnmpFreeDescriptor-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.]

Eine WinSNMP-Anwendung verwendet die SnmpFreeDescriptor-Funktion , um die Microsoft WinSNMP-Implementierung darüber zu informieren, dass sie keinen Zugriff mehr auf ein Deskriptorobjekt benötigt. Diese WinSNMP-Funktion signalisiert der Implementierung, den speicher freizugeben, den sie für das Deskriptorobjekt zugewiesen hat.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeDescriptor(
  [in] smiUINT32   syntax,
  [in] smiLPOPAQUE descriptor
);

Parameter

[in] syntax

Gibt den Syntaxdatentyp des Zieldeskriptorobjekts an.

[in] descriptor

Zeiger auf eine smiOPAQUE-Struktur , die das zu freigebende Zieldeskriptorobjekt enthält.

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_SYNTAX_INVALID	Der Syntaxparameter ist ungültig.
SNMPAPI_OPERATION_INVALID	Der Deskriptorparameter ist ungültig. Weitere Informationen finden Sie im abschnitt "Hinweise".
SNMPAPI_OTHER_ERROR	Ein unbekannter oder nicht definierter Fehler ist aufgetreten.

Hinweise

Die Implementierung weist Arbeitsspeicher für Ausgabedeskriptorobjekte mit variablen Längen zu und verwaltet diesen. Diese Speicherzuordnung und -zuordnung sind auf die Implementierung beschränkt, mit Ausnahme der Schnittstelle, die die SnmpFreeDescriptor-Funktion bereitstellt. Weitere Informationen finden Sie unter Freigeben von WinSNMP-Deskriptoren.

Die Implementierung gibt den SNMPAPI_OPERATION_INVALID Fehlercode zurück, wenn der Deskriptorparameter eine Speicherzuordnung angibt, die die Implementierung in einem vorherigen Aufruf von SnmpFreeDescriptor freigegeben hat. Die Funktion gibt denselben Fehlercode zurück, wenn der Deskriptorparameter eine Speicherzuordnung angibt, die die Implementierung für die aufrufende WinSNMP-Anwendung nicht vorgenommen 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

Weitere Informationen

Übersicht über die WinSNMP-API