CM_Locate_DevNodeW関数 (cfgmgr32.h)

[アーティクル]
11/20/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 ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてCM_Locate_DevNodeを定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	cfgmgr32.h (Cfgmgr32.h を含む)
ライブラリ	Cfgmgr32.lib
DLL	CfgMgr32.dll

次の方法で共有