CM_Locate_DevNodeW関数 (cfgmgr32.h)
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 |