SnmpUtilIdsToA-Funktion (snmp.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 SnmpUtilIdsToA-Funktion konvertiert einen Objektbezeichner (Object Identifier, OID) in eine null-endende Zeichenfolge. Diese Funktion ist ein Element der SNMP-Hilfsprogramm-API.
Syntax
LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
[in] UINT *Ids,
[in] UINT IdLength
);
Parameter
[in] Ids
Zeiger auf ein Array von ganzen Zahlen ohne Vorzeichen. Das Array enthält die Sequenz von Zahlen, die die OID enthält. Der Parameter IdLength gibt die Länge des Arrays an.
Weitere Informationen finden Sie in den folgenden Abschnitten für Rückgabewerte und Hinweise.
[in] IdLength
Gibt die Anzahl der Elemente im Array an, auf das der Ids-Parameter verweist.
Rückgabewert
Die Funktion gibt eine NULL-endende Zeichenfolge zurück, die die Zeichenfolgendarstellung des Zahlenarrays enthält, auf das der Ids-Parameter verweist. Die Zeichenfolge enthält eine Sequenz von Zahlen, die durch Punkte (".") getrennt sind; Beispiel: 1.3.6.1.4.1.311.
Wenn der Ids-Parameter NULL ist oder der IdLength-Parameter null angibt, gibt die Funktion die Zeichenfolge "<null oid>" zurück.
Die maximale Länge der zurückgegebenen Zeichenfolge beträgt 256 Zeichen. Wenn die Länge der Zeichenfolge 256 Zeichen überschreitet, wird die Zeichenfolge abgeschnitten und mit einer Sequenz von drei Punkten ("...") beendet.
Hinweise
Die SnmpUtilIdsToA-Funktion kann beim Debuggen von SNMP-Anwendungen helfen.
Beachten Sie, dass beim Aufrufen von SnmpUtilIdsToA die folgenden Speichereinschränkungen gelten:
- Der Ids-Parameter muss auf einen gültigen Speicherblock mit mindestens IdLength-Ganzzahlen verweisen, oder der Funktionsaufruf führt zu einer Zugriffsverletzungs-Ausnahme.
- Die von SnmpUtilIdsToA zurückgegebene Zeichenfolge befindet sich im Arbeitsspeicher, den die SNMP-Hilfsprogramm-API zuordnet. Die Anwendung sollte keine Annahmen über die Speicherbelegung treffen. Die Daten sind garantiert gültig, bis Sie SnmpUtilIdsToA erneut aufrufen. Daher sollten Sie vor dem erneuten Aufrufen der Funktion die Daten an einen anderen Speicherort kopieren.
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 | snmp.h |
| Bibliothek | Snmpapi.lib |
| DLL | Snmpapi.dll |