Compartir a través de

Función WdfRegistryRemoveKey (wdfregistry.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfRegistryRemoveKey quita la clave del Registro asociada a un objeto de clave del Registro de marco especificado y, a continuación, elimina el objeto de clave del Registro.

Sintaxis

NTSTATUS WdfRegistryRemoveKey(
  [in] WDFKEY Key
);

Parámetros

[in] Key

Identificador de un objeto de clave del Registro que representa una clave del Registro abierta.

Valor devuelto

WdfRegistryRemoveKey devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, el método podría devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_INVALID_DEVICE_REQUEST

no se llamó a WdfRegistryRemoveKey en IRQL = PASSIVE_LEVEL.
STATUS_ACCESS_DENIED
 El controlador no abrió la clave del Registro con acceso de eliminación.
STATUS_NOT_IMPLEMENTED
 Consulte la sección Comentarios.
 

Este método también puede devolver otros valores de NTSTATUS.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Observaciones

Nota

Antes de llamar a WdfRegistryRemoveKey, asegúrese de que se han eliminado todas las claves y valores de la clave especificada. Elimine primero cada subclave, empezando por las claves hoja y trabajando hacia arriba.

nota  

Desde un controlador KMDF, no llame a WdfRegistryRemoveKey y, a continuación, WdfRegistryClose en la misma clave. WDFKEY ya no es válido después de que WdfRegistryRemoveKey devuelva.

 
Aunque es legal que un controlador UMDF llame a WdfRegistryRemoveKey, la llamada siempre devuelve STATUS_NOT_IMPLEMENTED. Para eliminar el objeto WDFKEY, un controlador UMDF debe llamar a WdfRegistryClose.

Para obtener más información sobre los objetos de clave del Registro, vea Using the Registry in Framework-Based Drivers.

Ejemplos

En el ejemplo de código siguiente se quita una clave del Registro y se elimina el objeto de clave del Registro.

NTSTATUS  status;

status = WdfRegistryRemoveKey(Key);

Requisitos

Requisito Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
versión mínima de UMDF 2.0
encabezado de wdfregistry.h (incluya Wdf.h)
biblioteca de Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
irQL PASSIVE_LEVEL
reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)