Compartir a través de

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

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método DeleteNamedValue elimina un nombre de valor del Registro.

Sintaxis

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

Parámetros

[in] pwszName

Puntero a una cadena terminada en null que contiene un nombre de valor del Registro.

Valor devuelto

DeleteNamedValue devuelve S_OK si la operación se realiza correctamente. De lo contrario, el método podría devolver el siguiente valor:

Código devuelto Descripción
E_INVALIDARG
 El llamador proporcionó un argumento de entrada no válido.
 

Este método puede devolver uno de los otros valores que contiene Winerror.h.

Comentarios

Antes de que un controlador llame a DeleteNamedValue, debe llamar a IWDFPropertyStoreFactory::RetrieveDevicePropertyStore para obtener la interfaz IWDFNamedPropertyStore2 .

Para obtener más información sobre el acceso al registro, consulte Uso del Registro en controladores basados en UMDF.

Ejemplos

El ejemplo de código siguiente es una función de devolución de llamada IObjectCleanup::OnCleanup para un objeto de dispositivo. Si el controlador había agregado previamente un valor a la clave DEVICEMAP del Registro, la función de devolución de llamada elimina el 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 Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1,9
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore