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)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)