Compartir a través de

Función ZwDeleteKey (wdm.h)

  • Artículo

La rutina ZwDeleteKey elimina una clave abierta del Registro.

Sintaxis

NTSYSAPI NTSTATUS ZwDeleteKey(
  [in] HANDLE KeyHandle
);

Parámetros

[in] KeyHandle

Controle la clave del Registro que se va a eliminar. El identificador se crea mediante una llamada correcta a ZwCreateKey o ZwOpenKey.

Valor devuelto

ZwDeleteKey devuelve un valor NTSTATUS. Entre los valores devueltos posibles se incluyen:

  • STATUS_SUCCESS

  • STATUS_ACCESS_DENIED

  • STATUS_INVALID_HANDLE

  • STATUS_CANNOT_DELETE (ver comentarios)

Comentarios

Antes de llamar a ZwDeleteKey, 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.

El identificador debe haberse abierto para que el acceso DELETE a esta rutina se realice correctamente. Para obtener más información, vea el parámetro DesiredAccess para ZwCreateKey.

Una llamada a ZwDeleteKey hace que el identificador especificado en el parámetro KeyHandle (y todos los demás identificadores de la clave eliminada) no sean válidos. Después de llamar a ZwDeleteKey invalida los identificadores de clave, debe llamar a ZwClose para cerrar los identificadores de clave.

Para obtener más información sobre cómo trabajar con claves del Registro, consulte Uso del Registro en un controlador.

Si la llamada a esta función se produce en modo de usuario, debe usar el nombre "NtDeleteKey" en lugar de "ZwDeleteKey".

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Consulte también

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema

ZwCreateKey

ZwOpenKey