Método IWDFNamedPropertyStore2::D eleteNamedValue (wudfddi.h)

Artigo
02/07/2025

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]

O método DeleteNamedValue exclui um nome de valor do registro.

Sintaxe

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

Parâmetros

[in] pwszName

Um ponteiro para um cadeia de caracteresterminada nula que contém um nome de valor do Registro.

Valor de retorno

DeleteNamedValue retornará S_OK se a operação for bem-sucedida. Caso contrário, o método poderá retornar o seguinte valor:

Código de retorno	Descrição
E_INVALIDARG	O chamador forneceu um argumento de entrada inválido.

Esse método pode retornar um dos outros valores que Winerror.h contém.

Observações

Antes que um driver chame DeleteNamedValue, ele deve chamar IWDFPropertyStoreFactory::RetrieveDevicePropertyStore para obter a interface de IWDFNamedPropertyStore2.

Para obter mais informações sobre como acessar o registro, consulte Usando o Registro em drivers baseados em UMDF.

Exemplos

O exemplo de código a seguir é uma função de retorno de chamada IObjectCleanup::OnCleanup para um objeto de dispositivo. Se o driver tiver adicionado anteriormente um valor à chave DEVICEMAP do registro, a função de retorno de chamada excluirá o valor.

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;
    }    
}

Requisitos

Requisito	Valor
fim do suporte	Indisponível no UMDF 2.0 e posterior.
da Plataforma de Destino	Área de trabalho
versão mínima do UMDF	1.9
cabeçalho	wudfddi.h (inclua Wudfddi.h)
de DLL	WUDFx.dll

Consulte também

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore

Compartilhar via