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 del 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 ha abierto la clave del Registro con acceso de eliminación.
STATUS_NOT_IMPLEMENTED
 Consulte la sección Comentarios.
 

Este método también podría devolver otros valores NTSTATUS.

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

Comentarios

Nota

Antes de llamar a WdfRegistryRemoveKey, asegúrese de que se han eliminado todas las claves y los 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 Uso del Registro en controladores de Framework-Based.

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 Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfregistry.h (incluya Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)