RegDeleteKeyW 関数 (winreg.h)

サブキーとその値を削除します。 キー名では大文字と小文字が区別されないことに注意してください。

64 ビット Windows: WOW64 では、32 ビット アプリケーションは、64 ビット アプリケーションが表示するレジストリ ツリーとは別のレジストリ ツリーを表示します。 アプリケーションが代替レジストリ ビューのエントリを削除できるようにするには、RegDeleteKeyEx 関数を使用します。

構文

LSTATUS RegDeleteKeyW(
  [in] HKEY    hKey,
  [in] LPCWSTR lpSubKey
);

パラメーター

[in] hKey

開いているレジストリ キーへのハンドル。 このキーのアクセス権は、削除操作には影響しません。 アクセス権の詳細については、「レジストリ キーのセキュリティとアクセス権の」を参照してください。

このハンドルは、RegCreateKeyEx または RegOpenKeyEx 関数 によって返されます。または、次の 定義済みキーのいずれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in] lpSubKey

削除するキーの名前。 hKey が識別 キーのサブキーである必要がありますが、サブキーを持つことはできません。 このパラメーターは NULLできません。

この関数は、DELETE アクセス権を持つサブキーを開きます。

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

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

戻り値

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

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

備考

削除されたキーは、最後のハンドルが閉じられるまで削除されません。

削除するサブキーにはサブキーを含めてはなりません。 キーとそのすべてのサブキーを削除するには、サブキーを列挙して個別に削除する必要があります。 キーを再帰的に削除するには、RegDeleteTree を使用するか、SHDeleteKey 関数 します。

例

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

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winreg.h (Windows.h を含む)
ライブラリ	Advapi32.lib
DLL	Advapi32.dll

関連項目

RegCloseKey

RegCreateKeyEx の

RegDeleteTree を する

RegOpenKeyEx を する

レジストリ関数 を する

レジストリの概要

SHDeleteEmptyKey

SHDeleteKey を する