术语 | regdeletekeytransacted |
释义 | RegDeleteKeyTransacted 语法: C++ LONG WINAPI RegDeleteKeyTransacted( __in HKEY hKey, __in LPCTSTR lpSubKey, __in REGSAM samDesired, __reserved DWORD Reserved, __in HANDLE hTransaction, __reserved PVOID pExtendedParameter ); RegDeleteKeyTransacted功能 删除一个子项,其值从指定的平台,作为一个交易操作注册表中特定看法。请注意,键名不区分大小写。 参数 hKey [in] 句柄到打开注册表项。在这个关键不影响删除操作的访问权限。如需有关访问权限的信息,请参阅注册表关键的安全和访问权限。 这种处理是由RegCreateKeyEx的,RegCreateKeyTransacted,RegOpenKeyEx,或RegOpenKeyTransacted函数返回。它也可以是下列预定义项之一: HKEY_CLASSES_ROOT HKEY_CURRENT_CONFIG HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS lpSubKey [in] 键的名称被删除。这关键的必须是由hKey参数值指定的键子。 该函数打开与删除访问权的子项。 键名不区分大小写。 这个参数的值不能为NULL。 samDesired [in] 访问掩码的指定平台,登记处的具体意见。 ValueMeaning KEY_WOW64_32KEY 0x0200Delete从32位注册表视图的关键。 KEY_WOW64_64KEY 0x0100Delete从64位注册表视图的关键。 保留 这个参数是保留,必须为零。 hTransaction [in] 一个句柄,积极交易。这种处理是由CreateTransaction函数返回。 pExtendedParameter 这个参数是保留,必须为NULL。 返回值 如果函数成功,返回值是ERROR_SUCCESS。 如果函数失败,返回值是一个非零错误代码Winerror.h中定义。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标记的FormatMessage函数获得错误的一般说明。 备注 已删除的关键不是删除,直到最后一个句柄,它已关闭。 WOW64上,32位应用程序查看注册表树,它是从注册表树单独的64位应用程序视图。此功能使应用程序在删除备用注册表视图项。 该子项删除不能有子项。要删除一个键及其所有子项,您需要枚举子项,并删除他们的个人。要删除键递归,使用RegDeleteTree或SHDeleteKey功能。 如果函数成功,RegDeleteKeyTransacted删除从注册表中指定的键。整个关键,包括其所有值,将被删除。要删除一个交易操作整个树,使用一个处理RegCreateKeyTransacted或RegOpenKeyTransacted产生的RegDeleteTree功能。 要求: client最低支持Vista server最低支持 Windows Server 2008 HeaderWinreg.h(头文件:winuser.h) LibraryAdvapi32.lib DLLAdvapi32.dll Unicode和ANSI namesRegDeleteKeyTransactedW(Unicode)和RegDeleteKeyTransactedA(ANSI)的 参见 RegCreateKeyTransacted 注册表重定向 登记职能 RegOpenKeyTransacted 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年8月27日 ==英文原文==RegDeleteKeyTransacted Function Deletes a subkey and its values from the specified platform-specific view of the registry as a transacted operation. Note that key names are not case sensitive. Syntax C++ LONG WINAPI RegDeleteKeyTransacted( __in HKEY hKey, __in LPCTSTR lpSubKey, __in REGSAM samDesired, __reserved DWORD Reserved, __in HANDLE hTransaction, __reserved PVOID pExtendedParameter ); Parameters hKey [in] A handle to an open registry key. The access rights of this key do not affect the delete operation. For more information about access rights, see Registry Key Security and Access Rights . This handle is returned by the RegCreateKeyEx , RegCreateKeyTransacted , RegOpenKeyEx , or RegOpenKeyTransacted function. It can also be one of the following predefined keys : HKEY_CLASSES_ROOT HKEY_CURRENT_CONFIG HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS lpSubKey [in] The name of the key to be deleted. This key must be a subkey of the key specified by the value of the hKey parameter. The function opens the subkey with the DELETE access right. Key names are not case sensitive. The value of this parameter cannot be NULL. samDesired [in] An access mask the specifies the platform-specific view of the registry. ValueMeaning KEY_WOW64_32KEY 0x0200Delete the key from the 32-bit registry view. KEY_WOW64_64KEY 0x0100Delete the key from the 64-bit registry view. Reserved This parameter is reserved and must be zero. hTransaction [in] A handle to an active transaction. This handle is returned by the CreateTransaction function. pExtendedParameter This parameter is reserved and must be NULL. Return Value If the function succeeds, the return value is ERROR_SUCCESS. If the function fails, the return value is a nonzero error code defined in Winerror.h. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description of the error. Remarks A deleted key is not removed until the last handle to it is closed. On WOW64, 32-bit applications view a registry tree that is separate from the registry tree that 64-bit applications view. This function enables an application to delete an entry in the alternate registry view. The subkey to be deleted must not have subkeys. To delete a key and all its subkeys, you need to enumerate the subkeys and delete them individually. To delete keys recursively, use the RegDeleteTree or SHDeleteKey function. If the function succeeds, RegDeleteKeyTransacted removes the specified key from the registry. The entire key, including all of its values, is removed. To remove the entire tree as a transacted operation, use the RegDeleteTree function with a handle returned from RegCreateKeyTransacted or RegOpenKeyTransacted. Requirements Minimum supported clientWindows Vista Minimum supported serverWindows Server 2008 HeaderWinreg.h (include Windows.h) LibraryAdvapi32.lib DLLAdvapi32.dll Unicode and ANSI namesRegDeleteKeyTransactedW (Unicode) and RegDeleteKeyTransactedA (ANSI) See Also RegCreateKeyTransacted Registry Redirector Registry Functions RegOpenKeyTransacted Send comments about this topic to Microsoft Build date: 8/27/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa965883(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。