SnmpUtilIdsToA 関数 (snmp.h)

[SNMP は、[要件] セクションで指定されたオペレーティングシステムで使用できます。今後のバージョンでは変更されるか、利用できなくなる場合もあります。代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。

SnmpUtilIdsToA 関数は、オブジェクト識別子 (OID) を null で終わる文字列に変換します。この関数は、SNMP ユーティリティ API の要素です。

構文

LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
  [in] UINT *Ids,
  [in] UINT IdLength
);

[in] Ids

符号なし整数の配列へのポインター。配列には、OID に含まれる数値のシーケンスが含まれています。 IdLength パラメーターは、配列の長さを指定します。

詳細については、次の「戻り値」および「解説」セクションを参照してください。

[in] IdLength

Ids パラメーターが指す配列内の要素の数を指定します。

この関数は、 Ids パラメーターが指す数値の配列の文字列表現を含む null で終わる文字列を返します。文字列には、ピリオド ('.') で区切られた数値のシーケンスが含まれています。たとえば、1.3.6.1.4.1.311 などです。

Ids パラメーターが null の場合、または IdLength パラメーターで 0 が指定されている場合、関数は文字列 "null oid>"< を返します。

返される文字列の最大長は 256 文字です。文字列の長さが 256 文字を超える場合、文字列は切り捨てられ、3 つのピリオド ('...') のシーケンスで終了します。

SnmpUtilIdsToA 関数は、SNMP アプリケーションのデバッグに役立ちます。

SnmpUtilIdsToA を呼び出すときは、次のメモリ制限が適用されることに注意してください。

Ids パラメーターは、少なくとも IdLength 整数の有効なメモリブロックを指している必要があります。または、関数呼び出しによってアクセス違反の例外が発生します。
SnmpUtilIdsToA によって返される文字列は、SNMP ユーティリティ API によって割り当てられるメモリ内に存在します。アプリケーションでは、メモリ割り当てについて何も想定しないでください。 データは SnmpUtilIdsToA を再度呼び出すまで有効であることが保証されるため、関数を再度呼び出す前に、データを別の場所にコピーする必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	snmp.h
Library	Snmpapi.lib
[DLL]	Snmpapi.dll