通过

WdfRegistryRemoveKey 函数 （wdfregistry.h）

  • 项目

[适用于 KMDF 和 UMDF]

WdfRegistryRemoveKey 方法删除与指定框架注册表项对象关联的注册表项，然后删除注册表项对象。

语法

NTSTATUS WdfRegistryRemoveKey(
  [in] WDFKEY Key
);

参数

[in] Key

表示已打开的注册表项的注册表项对象的句柄。

返回值

如果作成功，WdfRegistryRemoveKey 将返回STATUS_SUCCESS。 否则，该方法可能会返回以下值之一：

返回代码 描述
STATUS_INVALID_DEVICE_REQUEST

在 IRQL = PASSIVE_LEVEL 中未调用 WdfRegistryRemoveKey。
STATUS_ACCESS_DENIED
 驱动程序未打开具有删除访问权限的注册表项。
STATUS_NOT_IMPLEMENTED
 请参阅“备注”部分。
 

此方法还可以 返回其他NTSTATUS 值。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

言论

注意

在调用 WdfRegistryRemoveKey之前，请确保已删除给定密钥下的所有键和值。 首先删除每个子项，从叶键开始，并按自己的方式工作。

注释  

从 KMDF 驱动程序中，不要调用 WdfRegistryRemoveKey，然后在同一键上 WdfRegistryClose。 WdfRegistryRemoveKey 返回后，WDFKEY 不再有效。

 
虽然 UMDF 驱动程序调用 WdfRegistryRemoveKey是合法的，但调用始终返回 STATUS_NOT_IMPLEMENTED。 若要删除 WDFKEY 对象，UMDF 驱动程序应改为调用 WdfRegistryClose。

有关注册表项对象的详细信息，请参阅 使用 Framework-Based 驱动程序中的注册表。

例子

下面的代码示例删除注册表项并删除注册表项对象。

NTSTATUS  status;

status = WdfRegistryRemoveKey(Key);

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfregistry.h （包括 Wdf.h）
库 Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF）
IRQL PASSIVE_LEVEL
DDI 符合性规则 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）