wdfRegistryRemoveValue 函数 (wdfregistry.h)

[适用于 KMDF 和 UMDF]

WdfRegistryRemoveValue 方法从指定的注册表项中删除指定值及其数据。

语法

NTSTATUS WdfRegistryRemoveValue(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName
);

参数

[in] Key

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

[in] ValueName

指向包含值名称 UNICODE_STRING 结构的指针。

返回值

如果操作成功,WdfRegistryRemoveValue 将返回STATUS_SUCCESS。 否则,该方法可能会返回以下值之一:

返回代码 说明
STATUS_INVALID_DEVICE_REQUEST

未在 IRQL = PASSIVE_LEVEL 调用 WdfRegistryRemoveValue

STATUS_INVALID_PARAMETER
指定了无效参数。
STATUS_ACCESS_DENIED
驱动程序未打开具有KEY_SET_VALUE访问权限的注册表项。
 

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

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

注解

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

示例

下面的代码示例从指定的注册表项中删除 MyValue 值及其数据。

DECLARE_CONST_UNICODE_STRING(valueName, L"MyValue");

status = WdfRegistryRemoveValue(
                                Key,
                                &valueName
                                );

要求

   
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
Header wdfregistry.h (包括 Wdf.h)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI 符合性规则 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf)

另请参阅

UNICODE_STRING