大网数据广告活动
Windows 系统接口

ORDeleteKey function (Offreg.h)

· 52CE 我爱测

Deletes a subkey and its values from an offline registry hive.

Deletes a subkey and its values from an offline registry hive.

Syntax

DWORD ORDeleteKey(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpSubKey
);

Parameters

Handle [in]

A handle to an open registry key in an offline registry hive. This handle is returned by the ORCreateKey or OROpenKey function.

lpSubKey [in, optional]

The name of the key to be deleted. It must be a subkey of the key that Handle identifies, but it cannot have subkeys.

If the subkey does not exist, the function returns ERROR_NOT_FOUND.

If this parameter is NULL, the function deletes the key specified by the Handle parameter. If the key specified by the Handle parameter is the root key of the hive, the function returns ERROR_INVALID_PARAMETER.

Key names are not case sensitive.

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. Possible error codes include the following:

  • If the specified subkey does not exist, the function returns ERROR_FILE_NOT_FOUND.
  • If the specified subkey is the root key of the registry hive, the function returns ERROR_INVALID_PARAMETER.
  • If the specified subkey has subkeys, the function returns ERROR_KEY_HAS_CHILDREN.

Remarks

If the specified registry key exists, it is marked as deleted. A deleted key is not removed until the last handle to it is closed.

The key to be deleted must not have subkeys. To delete a key and all its subkeys, use the OREnumKey function to enumerate the subkeys and delete them individually.

Only the ORCloseKey function may be called on a deleted key; all other offline registry operations fail. If the deleted key was explicitly created by calling ORCreateKey, resources associated with the key are released when the last handle to the deleted key is closed.

Requirements

Requirement Value
Redistributable Windows Offline Registry library version 1.0 or later
Header Offreg.h
DLL Offreg.dll

See also

ORCloseKey

ORCreateKey

OREnumKey

OROpenKey

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。