SHDeleteKey レジストリツリーの削除

Cの宣言:

DWORD SHDeleteKey(
	HKEY hKey,
	LPCTSTR SubKeyName);

説明:

SubKeyNameで指定されたレジストリキーおよびそのサブキーを削除する。各レジストリキーにある値も削除される。

NTの場合、削除するレジストリキーにサブキーが存在してはならない。

引数の意味は以下の通り。
hKey レジストリキーのハンドル。
SubKeyName 削除するサブキーの名前。

戻り値はエラーコードである。

Cのサンプル:

SHDeleteKeyを使用して、HKEY_CURRENT_USERにある"Software\masapico\test"というキーおよびそのキーにある値を削除する。
void DeleteKey(void)
{
	HKEY hKey;

	/* レジストリキーのオープン */
	RegOpenKeyEx(
		HKEY_CURRENT_USER,
		"Software\\masapico",
		0,
		KEY_ALL_ACCESS,
		&hKey);

	/* キーの削除 */
	SHDeleteKey(hKey, "test");

	/* 終了 */
	RegCloseKey(hKey);
}

(original text:1999/09/05 更新)

本ドキュメントの内容は保証しません。本ドキュメントによって生じた結果について、一切の責任を負いません。