通过

IWDFNamedPropertyStore2：:D eleteNamedValue 方法 (wudfddi.h)

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

DeleteNamedValue 方法从注册表中删除值名称。

语法

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

参数

[in] pwszName

指向包含注册表值名称的 以 null 结尾的字符串的指针。

返回值

如果操作成功，DeleteNamedValue 将返回S_OK。 否则，该方法可能会返回以下值：

返回代码 说明
E_INVALIDARG
 调用方提供的输入参数无效。
 

此方法可能会返回 Winerror.h 包含的其他值之一。

注解

在调用 DeleteNamedValue 之前，驱动程序必须调用 IWDFPropertyStoreFactory：：RetrieveDevicePropertyStore 以获取 IWDFNamedPropertyStore2 接口。

有关访问注册表的详细信息，请参阅 在基于 UMDF 的驱动程序中使用注册表。

示例

下面的代码示例是设备对象的 IObjectCleanup：：OnCleanup 回调函数。 如果驱动程序以前向注册表的 DEVICEMAP 键添加了值，则回调函数将删除该值。

VOID 
CMyDevice::OnCleanup(
 IWDFObject*  pWdfObject
)
{
    UNREFERENCED_PARAMETER(pWdfObject);
 
    if ((m_CreatedLegacyHardwareKey == TRUE) && 
        (m_LegacyHardwarePropertyStore != NULL))
    {
        m_LegacyHardwarePropertyStore->DeleteNamedValue(m_PdoName);
        SAFE_RELEASE(m_LegacyHardwarePropertyStore);
        delete[] m_PdoName;
    }    
}

要求

要求 值
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.9
标头 wudfddi.h (包括 Wudfddi.h)
DLL WUDFx.dll

另请参阅

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory：：RetrieveDevicePropertyStore