SnmpMgrStrToOid-Funktion (mgmtapi.h)
[SNMP ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]
Die SnmpMgrStrToOid-Funktion konvertiert das Zeichenfolgenformat eines Objektbezeichners in die interne Objektbezeichnerstruktur. Diese Funktion ist ein Element der SNMP-Verwaltungs-API.
Syntax
BOOL SNMP_FUNC_TYPE SnmpMgrStrToOid(
[in] LPSTR string,
[out] AsnObjectIdentifier *oid
);
Parameter
[in] string
Zeiger auf eine zu konvertierende NULL-endende Zeichenfolge.
[out] oid
Zeiger auf eine Objektbezeichnervariable, um den konvertierten Wert zu empfangen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Wenn die Funktion erfolgreich ist, rufen Sie die SnmpUtilOidFree-Funktion auf, um den für den konvertierten Objektbezeichner zugeordneten Arbeitsspeicher freizugeben.
Wenn eine Anwendung einen gültigen Objektbezeichner an SnmpMgrStrToOid übergibt, die angeforderte Variable jedoch nicht abrufen kann, ist die Syntax der Systemgruppe und des Objektbezeichners falsch. Dies liegt daran, dass SnmpMgrStrToOid davon ausgeht, dass sich der Objektbezeichner unter der Internet-MIB der Verwaltungsunterstruktur befindet.
Sie müssen dem Objektbezeichner immer einen Punkt (.) vorangestellt haben, um die richtige Systemgruppe abzurufen (z. B. ".1.3.6.1.2.1.1"). Wenn eine Anwendung die Variable "1.3.6.1.2.1.1" übergibt, kann SnmpMgrStrToOid den Objektbezeichner nicht richtig interpretieren.
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 | mgmtapi.h |
| Bibliothek | Mgmtapi.lib |
| DLL | Mgmtapi.dll |