OROpenKey 関数

指定したレジストリキーをオフラインレジストリハイブで開きます。

構文

DWORD OROpenKey(
  _In_     ORHKEY  Handle,
  _In_opt_ PCWSTR  lpSubKeyName,
  _Out_    PORHKEY phkResult
);

ハンドル [入力]

オフラインレジストリハイブで開いているレジストリキーへのハンドル。

lpSubKeyName [in, optional]

開くレジストリキーの名前を含む UNICODE 文字列へのポインター。このキーは、 Handle パラメーターで識別されるキーのサブキーである必要があります。

キー名では大文字と小文字は区別されません。

このパラメーターが NULL または空の文字列へのポインターである場合、関数は渡されたのと同じハンドルを返します。 Handle パラメーターで指定されたキーがハイブのルートキーである場合、関数はERROR_INVALID_PARAMETERを返します。

詳細については、「レジストリ要素のサイズ制限」を参照してください。

phkResult [out]

開かれたキーへのハンドルを受け取る変数へのポインター。ハンドルの使用が完了したら、 ORCloseKey 関数を使用してキーを閉じます。

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は Winerror.h で定義されている 0 以外のエラーコードです。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。

返されるハンドルがハイブのルートキーへのハンドルである場合、関数はERROR_INVALID_PARAMETERを返します。

指定したキーが削除済みとしてマークされている場合、この関数はERROR_KEY_DELETEDを返します。

OROpenKey 関数を使用して、オフラインレジストリハイブでルートキーを開くことはできません。ハイブのルートキーへのハンドルを取得するには、 OROpenHive 関数を使用してハイブをメモリに読み込みます。

要件	値
再頒布可能パッケージ	Windows オフラインレジストリライブラリバージョン 1.0 以降
ヘッダー	Offreg.h
[DLL]	Offreg.dll