SetupDiOpenClassRegKeyExW 関数 (setupapi.h)

[アーティクル]
03/01/2024

SetupDiOpenClassRegKeyEx 関数は、デバイスセットアップクラスレジストリキー、デバイスインターフェイスクラスレジストリキー、または特定のクラスのサブキーを開きます。この関数は、指定したキーをローカルコンピューターまたはリモートコンピューターで開きます。

構文

WINSETUPAPI HKEY SetupDiOpenClassRegKeyExW(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired,
  [in]           DWORD      Flags,
  [in, optional] PCWSTR     MachineName,
                 PVOID      Reserved
);

パラメーター

[in, optional] ClassGuid

レジストリキーを開くクラスの GUID へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。このパラメーターが NULL の場合、クラスツリーのルート (HKLM\SYSTEM\CurrentControlSet\Control\Class) が開きます。

[in] samDesired

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

[in] Flags

開くレジストリキーの種類。これは、次のいずれかによって指定されます。

DIOCR_INSTALLER

セットアップクラスキーを開きます。 ClassGuid が NULL の場合は、クラスインストーラーブランチのルートキーを開きます。

DIOCR_INTERFACE

インターフェイスクラスキーを開きます。 ClassGuid が NULL の場合は、インターフェイスクラスブランチのルートキーを開きます。

[in, optional] MachineName

必要に応じて、指定したキーを開くリモートコンピューターの名前を含む文字列を指します。

注意事項

この機能は削除されたため、この関数を使用してリモートマシンにアクセスすることは、Windows 8 および Windows Server 2012 以降ではサポートされていません。

Reserved

予約済み。 NULL にする必要があります。

戻り値

SetupDiOpenClassRegKeyEx は、このセットアップクラスに関する情報を格納/取得できる、開いているレジストリキーへのハンドルを返します。

関数が失敗した場合は、INVALID_HANDLE_VALUEを返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

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

SetupDiOpenClassRegKeyEx では、レジストリキーがまだ存在しない場合は作成されません。

この関数の呼び出し元は、RegCloseKey を呼び出して、この関数から返されたハンドルを閉じる必要があります。

注意

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

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	setupapi.h (Setupapi.h を含む)
Library	Setupapi.lib

こちらもご覧ください

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey