次の方法で共有

SetupDiCreateDeviceInterfaceRegKeyA 関数 (setupapi.h)

  • [アーティクル]

SetupDiCreateDeviceInterfaceRegKey 関数は、デバイス インターフェイスに関する情報を格納するためのレジストリ キーを作成し、キーへのハンドルを返します。

構文

WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
  [in]           HDEVINFO                  DeviceInfoSet,
  [in]           PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
                 DWORD                     Reserved,
  [in]           REGSAM                    samDesired,
  [in, optional] HINF                      InfHandle,
  [in, optional] PCSTR                     InfSectionName
);

パラメーター

[in] DeviceInfoSet

レジストリ キーを作成するインターフェイスを含む デバイス情報セットへのハンドル。 デバイス情報セットにリモート要素を含めてはなりません。

[in] DeviceInterfaceData

DeviceInfoSet内のデバイス インターフェイスを指定する SP_DEVICE_INTERFACE_DATA 構造体 ポインター。 このポインターは、SetupDiCreateDeviceInterfaceによって返される可能性があります。

Reserved

引っ込み思案。 0 にする必要があります。

[in] samDesired

作成中のキーに対して呼び出し元が要求するレジストリ セキュリティ アクセス。 REGSAM 型のレジストリ セキュリティ アクセス値については、Microsoft Windows SDK のドキュメントを参照してください。

[in, optional] InfHandle

新しく作成されたキーに対して実行される DDInstall セクションを含む、開いている INF ファイルへのハンドル。 このパラメーターは省略可能であり、NULLできます。 このパラメーターが NULLでない場合は、InfSectionName も指定する必要があります。

[in, optional] InfSectionName

InfHandleで指定された INF ファイル内の INF DDInstall セクション 名前へのポインター。 このセクションは、新しく作成されたキーに対して実行されます。 このパラメーターは省略可能であり、NULLできます。 このパラメーターを指定する場合は、InfHandle も指定する必要があります。

戻り値

SetupDiCreateDeviceInterfaceRegKey 成功した場合、この関数は、インターフェイス情報を格納および取得できる要求されたレジストリ キーへのハンドルを返します。 SetupDiCreateDeviceInterfaceRegKey 失敗した場合、関数はINVALID_HANDLE_VALUEを返します。 GetLastError 呼び出して、拡張エラー情報を取得します。

備考

この関数の呼び出し元は、Administrators グループのメンバーである必要があります。

デバイス インターフェイスの要求されたキーが既に存在する場合は、SetupDiCreateDeviceInterfaceRegKey はそのキーへのハンドルを返します。それ以外の場合は、SetupDiCreateDeviceInterfaceRegKey 、指定したデバイス インターフェイスの新しい不揮発性レジストリ キーを作成します。 この関数の呼び出し元は、デバイス インターフェイスのプライベート構成データをこのキーに格納できます。 デバイスのドライバーは、IoXxx ルーチンを使用して、このキーにアクセスできます。

RegCloseKeyを呼び出して、この関数から返されたハンドル 閉じます。

レイアウト ファイル (INF バージョン セクションの LayoutFile エントリで指定) を使用するインストールの場合、SetupDiCreateDeviceInterfaceRegKey を呼び出す 前に、SetupOpenAppendInfFile (Windows SDK ドキュメントで説明) を呼び出してレイアウト ファイルを開く必要があります。

deviceInfoSet で指定 デバイス情報セットには、ローカル コンピューター上の要素のみを含む必要があります。

手記

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

必要条件

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

関連項目

SetupDiCreateDeviceInterface の

SetupDiDeleteDeviceInterfaceRegKey の

SetupDiOpenDeviceInterfaceRegKey の