CM_Locate_DevNodeW関数 (cfgmgr32.h)

[アーティクル]
02/26/2024

CM_Locate_DevNode関数は、ローカルコンピューター上の指定したデバイスインスタンス ID に関連付けられているデバイスノードへのデバイスインスタンスハンドルを取得します。

構文

CMAPI CONFIGRET CM_Locate_DevNodeW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

パラメーター

[out] pdnDevInst

CM_Locate_DevNodeが取得するデバイスインスタンスハンドルへのポインター。取得されたハンドルは、ローカルコンピューターにバインドされます。

[in, optional] pDeviceID

デバイスインスタンス ID を表す NULL で終わる文字列へのポインター。この値が NULL の場合、または長さ 0 の文字列を指している場合、この関数はデバイスツリーのルートにあるデバイスへのデバイスインスタンスハンドルを取得します。

[in] ulFlags

呼び出し元がデバイスインスタンス識別子を提供する場合に適用される、次のいずれかのフラグ値を提供する ULONG 型の変数。

CM_LOCATE_DEVNODE_NORMAL

この関数は、デバイスが現在デバイスツリーで構成されている場合にのみ、指定されたデバイスのデバイスインスタンスハンドルを取得します。

CM_LOCATE_DEVNODE_PHANTOM

この関数は、デバイスが現在デバイスツリーで構成されているか、デバイスツリーで現在構成されていないデバイスである場合に、指定されたデバイスのデバイスインスタンスハンドルを取得します。

CM_LOCATE_DEVNODE_CANCELREMOVE

この関数は、デバイスが現在デバイスツリーで構成されている場合、またはデバイスツリーから削除されている場合に、指定されたデバイスのデバイスインスタンスハンドルを取得します。デバイスが削除処理中の場合、この関数はデバイスの削除を取り消します。

CM_LOCATE_DEVNODE_NOVALIDATION

使用されていません。

戻り値

操作が成功した場合、 CM_Locate_DevNode はCR_SUCCESSを返します。それ以外の場合、関数は Cfgmgr32.h で定義されているCR_Xxx エラーコードのいずれかを返します。

注釈

ローカルコンピューターにバインドされているデバイスインスタンスハンドルの使用については、「 CM_Get_Child」を参照してください。

注意

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

要件

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

こちらもご覧ください

CM_Get_Child

CM_Locate_DevNode_Ex