RegCloseKey 関数 (winreg.h)

  • [アーティクル]

指定したレジストリ キーへのハンドルを閉じます。

構文

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

パラメーター

[in] hKey

閉じる開いているキーへのハンドル。 ハンドルは、 RegCreateKeyEx、 RegCreateKeyTransacted、 RegOpenKeyEx、 RegOpenKeyTransacted、または RegConnectRegistry 関数によって開かれている必要があります。

戻り値

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

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

解説

指定したキーのハンドルは、閉じた後は無効になるため、使用しないでください。 キー ハンドルは、必要以上に長く開いたままにしないでください。

RegCloseKey 関数は、必ずしもを返す前にレジストリに情報を書き込むわけではありません。キャッシュがハード ディスクにフラッシュされるまでに数秒かかる場合があります。 アプリケーションがレジストリ情報をハード ディスクに明示的に書き込む必要がある場合は、 RegFlushKey 関数を使用できます。 ただし、RegFlushKey は多くのシステム リソースを使用するため、必要な場合にのみ呼び出す必要があります。

例

例については、「 サブキーを使用したキーの削除」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winreg.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

関連項目

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

RegOpenKeyEx

レジストリ関数

レジストリの概要