Freigeben über


SnmpFreeDescriptor-Funktion (winsnmp.h)

[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

SnmpEncodeMsg

SnmpOidCopy

SnmpStrToOid

WinSNMP-Funktionen

Übersicht über die WinSNMP-API