RegDeleteKeyTransactedA 関数 (winreg.h)
トランザクション操作として、レジストリの指定したプラットフォーム固有のビューからサブキーとその値を削除します。 キー名では大文字と小文字が区別されないことに注意してください。
構文
LSTATUS RegDeleteKeyTransactedA(
[in] HKEY hKey,
[in] LPCSTR lpSubKey,
[in] REGSAM samDesired,
DWORD Reserved,
[in] HANDLE hTransaction,
PVOID pExtendedParameter
);
パラメーター
[in] hKey
開いているレジストリ キーへのハンドル。 このキーのアクセス権は、削除操作には影響しません。 アクセス権の詳細については、「レジストリ キーのセキュリティとアクセス権の」を参照してください。
このハンドルは、
- 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 である必要があります。
[in] hTransaction
アクティブなトランザクションへのハンドル。 このハンドルは、CreateTransaction 関数によって返されます。
pExtendedParameter
このパラメーターは予約されており、NULL
戻り値
関数が成功した場合、戻り値はERROR_SUCCESS。
関数が失敗した場合、戻り値は Winerror.h で定義されている 0 以外のエラー コードです。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。
備考
削除されたキーは、最後のハンドルが閉じられるまで削除されません。
WOW64 では、32 ビット アプリケーションは、64 ビット アプリケーションが表示するレジストリ ツリーとは別のレジストリ ツリーを表示します。 この関数を使用すると、アプリケーションは代替レジストリ ビューのエントリを削除できます。
削除するサブキーにはサブキーを含めてはなりません。 キーとそのすべてのサブキーを削除するには、サブキーを列挙して個別に削除する必要があります。 キーを再帰的に削除するには、
関数が成功した場合、RegDeleteKeyTransacted レジストリから指定したキーを削除します。 すべての値を含むキー全体が削除されます。 トランザクション操作としてツリー全体を削除するには、RegCreateKeyTransacted または RegOpenKeyTransactedから返されるハンドル
手記
winreg.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RegDeleteKeyTransacted を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2008 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winreg.h (Windows.h を含む) |
ライブラリ | Advapi32.lib |
DLL | Advapi32.dll |
関連項目
RegCreateKeyTransacted の
レジストリ関数 を
レジストリ リダイレクター の