Метод IWDFNamedPropertyStore2::D eleteNamedValue (wudfddi.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы 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