CM_Get_Device_ID_List_Size_ExW関数 (cfgmgr32.h)

[Windows 8とWindows Server 2012以降、この関数は非推奨となりました。 代わりに CM_Get_Device_ID_List_Size を使用してください。]

CM_Get_Device_ID_List_Size_Ex関数は、ローカルまたはリモート コンピューターのデバイス インスタンスのデバイス インスタンス ID の一覧を保持するために必要なバッファー サイズを取得します。

構文

CMAPI CONFIGRET CM_Get_Device_ID_List_Size_ExW(
  [out]          PULONG   pulLen,
  [in, optional] PCWSTR   pszFilter,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

パラメーター

[out] pulLen

必要なバッファー サイズを表す値を文字数で受け取ります。

[in, optional] pszFilter

コンピューターのデバイス インスタンス識別子のサブセット ( NULL) を指定する文字列への呼び出し元指定ポインター。 ulFlags の次の説明を参照してください。

[in] ulFlags

検索フィルターを指定する、呼び出し元から提供される省略可能なビット フラグの 1 つ。 フラグが指定されていない場合、関数は、すべてのデバイス インスタンスのすべてのインスタンス識別子を保持するために必要なバッファー サイズを提供します。 ビット フラグの一覧については、CM_Get_Device_ID_List_Exの ulFlags の説明を参照してください。

[in, optional] hMachine

呼び出し元から指定されたマシン ハンドル。 CM_Connect_Machineの前の呼び出しから取得されます。

メモこの機能は削除されたため、この関数を使用してリモート マシンにアクセスすることは、Windows 8 および Windows Server 2012 以降ではサポートされていません。

 

戻り値

操作が成功した場合、関数は CR_SUCCESSを返します。 それ以外の場合は、 Cfgmgr32.h で定義されているCR_プレフィックス付きのエラー コードのいずれかを返します。

注釈

CM_Get_Device_ID_List_Size_Ex関数を呼び出して、CM_Get_Device_ID_List_Exに必要なバッファー サイズを決定する必要があります。

pulLen が指す場所に指定されたサイズ値は、すべてのデバイス インスタンス識別子文字列と終端の NULL を保持するのに十分な大きさのバッファー サイズを表します。 指定された値は、実際には必要以上に大きいバッファー サイズを表す可能性があるため、値が 、CM_Get_Device_ID_List_Ex が提供する文字列の実際の長さを表すと想定しないでください。

デバイス インスタンス ID の詳細については、「 デバイス識別文字列」を参照してください。

リモート マシンにアクセスするための機能は、Windows 8およびWindows Server 2012以降のオペレーティング システムで削除されているため、これらのバージョンの Windows で実行している場合はリモート マシンにアクセスできません。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	cfgmgr32.h (Cfgmgr32.h を含む)
Library	Cfgmgr32.lib

こちらもご覧ください

CM_Get_Device_ID_List_Size