CM_Enumerate_EnumeratorsW関数 (cfgmgr32.h)
CM_Enumerate_Enumerators関数は、各列挙子の名前を指定して、ローカル コンピューターのデバイス列挙子を列挙します。
構文
CMAPI CONFIGRET CM_Enumerate_EnumeratorsW(
[in] ULONG ulEnumIndex,
[out] PWSTR Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
パラメーター
[in] ulEnumIndex
コンピューターのデバイス列挙子の一覧に呼び出し元から指定されたインデックス。 詳細については、次の 「解説 」セクションを参照してください。
[out] Buffer
列挙子名を受け取るバッファーのアドレス。 このバッファーは、MAX_DEVICE_ID_LENサイズにする必要があります (または、 Buffer を 0 に設定し、 puLength によって参照される場所の実際の名前の長さを取得します)。
[in, out] pulLength
バッファー サイズを保持する場所の呼び出し元から指定されたアドレス。 呼び出し元は、Buffer が指すバッファーの長さを指定 します。 関数は、この値を列挙子の名前文字列の実際のサイズに置き換えます。 呼び出し元が指定したバッファー長が小さすぎる場合、関数は必要なバッファー サイズを提供し、CR_BUFFER_SMALLを返します。
[in] ulFlags
使用しません。0 にする必要があります。
戻り値
操作が成功した場合、関数は CR_SUCCESSを返します。 それ以外の場合は、 Cfgmgr32.h で定義されているCR_プレフィックス付きのエラー コードのいずれかを返します。
注釈
ローカル コンピューターのデバイス列挙子を列挙するには、ulEnumIndex インデックス値 0 から始めて、CM_Enumerate_Enumeratorsを繰り返し呼び出します。 関数がCR_NO_SUCH_VALUEを返すまで、後続の呼び出しごとにインデックス値をインクリメントします。
列挙子名を取得した後、名前を CM_Get_Device_ID_Listへの入力として使用できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | cfgmgr32.h (Cfgmgr32.h を含む) |
| Library | Cfgmgr32.lib |