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

Die WinSNMP SnmpStrToOid-Funktion konvertiert das gepunktete numerische Zeichenfolgenformat eines SNMP-Objektbezeichners, z. B. "1.2.3.4.5.6", in die interne binäre Darstellung.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpStrToOid(
  [in]  LPCSTR   string,
  [out] smiLPOID dstOID
);

Parameter

[in] string

Zeiger auf eine zu konvertierende NULL-endende Objektbezeichnerzeichenfolge.

[out] dstOID

Zeiger auf eine smiOID-Struktur , die den konvertierten Wert empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Unteridentifizierer im konvertierten Objektbezeichner. Diese Zahl ist auch der Wert des len-Elements der smiOID-Struktur , auf die vom dstOID-Parameter verwiesen wird.

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

Hinweise

Die WinSNMP-Anwendung muss die SnmpFreeDescriptor-Funktion aufrufen, um Ressourcen freizugeben, die für das ptr-Element der smiOID-Struktur zugewiesen sind, auf die der dstOID-Parameter verweist. Bei der Eingabe ignoriert SnmpFreeDescriptor die Member dieser smiOID-Struktur . Die Microsoft WinSNMP-Implementierung überschreibt die smiOID-Member , wenn die Funktion erfolgreich abgeschlossen wurde.

Die SnmpStrToOid-Funktion schlägt fehl und gibt den SNMPAPI_OID_INVALID Fehlercode zurück, wenn der Zeichenfolgenparameter eine der folgenden Bedingungen erfüllt:

• Ist nicht null-beendet.
• Ist nicht die Textform eines gültigen Objektbezeichners.
• Ist unzureichend in der Länge; Alle Objektbezeichner müssen über zwei Unteridentifizierer verfügen.
• Überschreitet die MAXOBJIDSTRSIZE von 1408 Bytes.

Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Konzepte und Freigeben von WinSNMP-Deskriptoren.

Anforderungen

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

SnmpFreeDescriptor

WinSNMP-Funktionen

Übersicht über die WinSNMP-API

smiOID