Share via

SetupDiOpenDeviceInterfaceRegKey 関数 (setupapi.h)

  • [アーティクル]

SetupDiOpenDeviceInterfaceRegKey 関数は、デバイス インターフェイスに固有の情報を格納するためにアプリケーションとドライバーによって使用されるレジストリ サブキーを開きます。

構文

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

パラメーター

[in] DeviceInfoSet

レジストリ サブキーを開くデバイス インターフェイスを含むデバイス 情報セット へのポインター。

[in] DeviceInterfaceData

デバイス インターフェイスを指定する SP_DEVICE_INTERFACE_DATA 構造体へのポインター。 このポインターは、 SetupDiCreateDeviceInterface または SetupDiEnumDeviceInterfaces によって返されます。

Reserved

予約済み。 ゼロを指定してください。

[in] samDesired

レジストリ サブキーへの要求されたレジストリ セキュリティ アクセス。 REGSAM 型のレジストリ セキュリティ アクセス値の詳細については、Microsoft Windows SDKドキュメントを参照してください。

戻り値

SetupDiOpenDeviceInterfaceRegKey は 、開いているレジストリ キーへのハンドルを返します。 関数が失敗した場合は、INVALID_HANDLE_VALUEを返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

samDesired パラメーターで渡される値によっては、この関数の呼び出し元が Administrators グループのメンバーであることが必要になる場合があります。

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

要件

   
サポートされている最小のクライアント Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム Desktopユニバーサルの場合は、CM_Open_Device_Interface_Keyを呼び出します
Header setupapi.h (Setupapi.h を含む)
Library Setupapi.lib
[DLL] Setupapi.dll

関連項目

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces