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 |