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 を再度呼び出すまで有効であることが保証されるため、関数を再度呼び出す前に、データを別の場所にコピーする必要があります。

要件

こちらもご覧ください

SNMP 関数

簡易ネットワーク管理プロトコル (SNMP) の概要

SnmpUtilOidToA