SetupDiOpenClassRegKeyExA 関数 (setupapi.h)
構文
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
パラメーター
[in, optional] ClassGuid
レジストリ キーを開くクラスの GUID へのポインター。 このパラメーターは省略可能であり、NULL
[in] samDesired
開くキーのレジストリ セキュリティ アクセス。 REGSAM 型のレジストリ セキュリティ アクセス値については、Microsoft Windows SDK のドキュメントを参照してください。
[in] Flags
開くレジストリ キーの種類。次のいずれかで指定します。
DIOCR_INSTALLER
セットアップ クラス キーを開きます。 ClassGuid
DIOCR_INTERFACE
インターフェイス クラス キーを開きます。 ClassGuid
[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 で使用できます。 |
ターゲット プラットフォーム の |
デスクトップ |
ヘッダー | setupapi.h (Setupapi.h を含む) |
ライブラリ | Setupapi.lib |
関連項目
SetupDiCreateDeviceInterfaceRegKey を
SetupDiOpenDevRegKey の