Función ZwDeleteKey (wdm.h)
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