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 |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherzuordnung ist ein Fehler aufgetreten. |
|
Der Syntaxparameter ist ungültig. |
|
Der Deskriptorparameter ist ungültig. Weitere Informationen finden Sie im abschnitt "Hinweise". |
|
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 |