IGPEInformation::GetRegistryKey メソッド (gpedit.h)

GetRegistryKey メソッドは、GPO の指定されたセクションのレジストリキーのルートへのハンドルを取得します。

構文

HRESULT GetRegistryKey(
  [in]  DWORD dwSection,
  [out] HKEY  *hKey
);

[in] dwSection

GPO セクションを指定します。このパラメーターには、次の値のいずれかを指定できます。

ユーザーセクション

[コンピューター] セクション

[out] hKey

レジストリキーへのハンドルを受け取ります。このハンドルは、すべてのアクセス権で開かれます。詳細については、「レジストリキーのセキュリティとアクセス権」を参照してください。

メソッドが成功した場合、戻り値は S_OK。それ以外の場合、メソッドは Platform SDK ヘッダーファイル WinError.h で定義されている COM エラーコードのいずれかを返します。レジストリ情報が読み込まれていない場合、メソッドは E_FAILを返します。

レジストリハンドルは、レジストリキーのルートへのハンドルです。 Policies キーの値を取得または設定するには、まず RegOpenKeyEx 関数を呼び出して Software\Policies キーを 開きます。

レジストリハンドルの使用が完了したら、 RegCloseKey 関数を呼び出してハンドルを閉じます。