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