CM_Locate_DevNodeA関数 (cfgmgr32.h)

  • [アーティクル]

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

構文

CMAPI CONFIGRET CM_Locate_DevNodeA(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_A 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」を参照してください。

Note

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