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

Статья
02/07/2025

[ предупреждение: 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-terminated, содержащую имя значения реестра.

Возвращаемое значение

DeleteNamedValue возвращает S_OK, если операция завершится успешно. В противном случае метод может вернуть следующее значение:

Возвращаемый код	Описание
E_INVALIDARG	Вызывающий объект предоставил недопустимый входной аргумент.

Этот метод может возвращать одно из других значений, содержащихся в Winerror.h.

Замечания

Перед вызовом драйвера DeleteNamedValueнеобходимо вызвать интерфейс IWDFPropertyStoreFactory::RetrieveDevicePropertyStore для получения интерфейса IWDFNamedPropertyStore 2.

Дополнительные сведения о доступе к реестру см. в статье Использование реестра вдрайверов на основе 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 (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore

Поделиться через