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

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso 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 com 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 uma cadeia de caracteres terminada em nulo que contém um nome de valor do Registro.

Retornar valor

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

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

Comentários

Antes que um driver chame DeleteNamedValue, ele deve chamar IWDFPropertyStoreFactory::RetrieveDevicePropertyStore para obter a interface 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

Confira também

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore