SHDeleteKey

SHDeleteKey

功能：用来删除一个注册表键，包括其下面的子键。

VB声明

Declare SHDeleteKey Lib "shlwapi.dll" Alias "SHDeleteKeyA" (ByVal hKey As Long, ByVal pszSubKey As String) As Long

说明

删除一个注册表键，包括其下面的子键。

RegDeleteKey 也可用来删除一个键值。在 Win 95/98 平台下，也可用来删除整个子键和键值。但是在Windows NT/2000平台下，只能用来删除没有子键的键。

返回值

Long，零（ERROR_SUCCESS）表示成功。其他任何值都代表一个错误代码

参数表

参数 类型及说明

hKey Long，一个已打开项的句柄，或者标准项名之一

lpSubKey String，要删除项的名字。

VC函数原型

LONG WINAPI SHDeleteKey (

__in HKEY hKey,

__in LPCTSTR lpSubKey

);

参数：

hKey

注册表打开的键值的句柄。删除的键值必须是拥有访问权限的。如需详细信息，请参阅注册表项的安全和访问权限。

必须使用下列的常量：

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

lpsubkey

被删除的键值名称。它必须是hkey的一个子项，但它并不能有子项。此参数不能为空。

键值的名称不区分大小写。

如需详细信息，请参阅注册表元素的大小限制。

返回值

如果函数成功，返回值是ERROR_SUCCESS。

如果函数失败，返回值是非零错误代码定义在 Winerror.h 。获得一个通用的描述错误，您可以使用FormatMessage 函数的 format_message_from_system 标志。