RegDeleteKeyExW 関数 (winreg.h)
レジストリの指定したプラットフォーム固有のビューからサブキーとその値を削除します。 キー名では大文字と小文字は区別されないことに注意してください。
トランザクション操作としてサブキーを削除するには、 RegDeleteKeyTransacted 関数を呼び出します。
構文
LSTATUS RegDeleteKeyExW(
[in] HKEY hKey,
[in] LPCWSTR lpSubKey,
[in] REGSAM samDesired,
DWORD Reserved
);
パラメーター
[in] hKey
開いているレジストリ キーへのハンドル。 このキーのアクセス権は、削除操作には影響しません。 アクセス権の詳細については、「 レジストリ キーのセキュリティとアクセス権」を参照してください。
このハンドルは、 RegCreateKeyEx または RegOpenKeyEx 関数によって返されます。または、次の 定義済みキーのいずれかを指定できます。
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
[in] lpSubKey
削除するキーの名前。 このキーは、 hKey パラメーターの値で指定されたキーのサブキーである必要があります。
関数は、DELETE アクセス権を持つサブキーを開きます。
キー名では大文字と小文字は区別されません。
このパラメーターの値を NULL にすることはできません。
[in] samDesired
アクセス マスク は、レジストリのプラットフォーム固有のビューを指定します。
値 | 意味 |
---|---|
|
32 ビット レジストリ ビューからキーを削除します。 |
|
64 ビット レジストリ ビューからキーを削除します。 |
Reserved
このパラメーターは予約されており、0 である必要があります。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は Winerror.h で定義されている 0 以外のエラー コードです。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。
注釈
削除されたキーは、最後のハンドルが閉じられるまで削除されません。
WOW64 では、32 ビット アプリケーションは、64 ビット アプリケーションが表示するレジストリ ツリーとは別のレジストリ ツリーを表示します。 この関数を使用すると、アプリケーションは代替レジストリ ビューのエントリを削除できます。
削除するサブキーにサブキーを含めてはいけません。 キーとそのすべてのサブキーを削除するには、サブキーを列挙して個別に削除する必要があります。 キーを再帰的に削除するには、 RegDeleteTree または SHDeleteKey 関数を 使用します。
関数が成功すると、 RegDeleteKeyEx は指定したキーをレジストリから削除します。 すべての値を含むキー全体が削除されます。
注意
レガシ バージョンの Windows では、この API も kernel32.dll によって公開されます。
注意
winreg.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RegDeleteKeyEx を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista、Windows XP Professional x64 Edition [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008、Windows Server 2003 SP1 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winreg.h (Windows.h を含む) |
Library | Advapi32.lib |
[DLL] | Advapi32.dll |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示