CM_Get_Device_Interface_List_SizeA関数 (cfgmgr32.h)

  • [アーティクル]

CM_Get_Device_Interface_List_Size関数は、CM_Get_Device_Interface_List関数に渡す必要があるバッファー サイズを取得します。

構文

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeA(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_A pDeviceID,
  [in]           ULONG       ulFlags
);

パラメーター

[out] pulLen

CM_Get_Device_Interface_Listによって返される複数の Unicode 文字列を保持するためのバッファーの必要な長さを文字単位で受け取る場所への呼び出し元指定のポインター。

[in] InterfaceClassGuid

デバイス インターフェイス クラスを識別する GUID を提供します。

[in, optional] pDeviceID

デバイス インスタンス ID を表す NULL で終わる文字列への呼び出し元指定ポインター。 指定した場合、関数は、指定したクラスのデバイスでサポートされているデバイス インターフェイスのシンボリック リンク名の長さを取得します。 この値が NULL の場合、または長さ 0 の文字列を指している場合、関数は、指定したクラスに属するすべてのインターフェイスのシンボリック リンク名の長さを取得します。

[in] ulFlags

呼び出し元から指定された次のいずれかのフラグが含まれています。

値 意味
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES
 関数は、指定された GUID とデバイス インスタンス ID (存在する場合) に一致するすべてのデバイスに関連付けられているデバイス インターフェイスを含むリストのサイズを提供します。
CM_GET_DEVICE_INTERFACE_LIST_PRESENT
 関数は、現在アクティブなデバイスに関連付けられているデバイス インターフェイスと、指定された GUID とデバイス インスタンス ID (存在する場合) と一致するデバイス インターフェイスを含むリストのサイズを提供します。

戻り値

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

注釈

注意

cfgmgr32.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてCM_Get_Device_Interface_List_Sizeを定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

CM_Get_Device_Interface_List