RegDeleteKey
RegDeleteKey
功能:用来删除一个注册表键值。
VB声明
Declare Function RegDeleteKey Lib "advapi32.dll" Alias "RegDeleteKeyA" (ByVal hKey As Long, ByVal lpSubKey As String) As Long
说明
删除现有项下方一个指定的子项
返回值
Long,零(ERROR_SUCCESS)表示成功。其他任何值都代表一个错误代码
参数表
参数 类型及说明
hKey Long,一个已打开项的句柄,或者标准项名之一
lpSubKey String,要删除项的名字。这个项的所有子
VC函数原型
LONG WINAPI RegDeleteKey(
__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 标志。
言论
删除的键值不能取消,直至最后处理它被关闭。
被删除的键值不能有子项。删除的一个键值和所有其子项,您需要枚举子项,并单独删除他们。删除键递归,使用 RegDeleteTree 或 SHDeleteKey 函数。