Função ZwClose (wdm.h)

A rotina ZwClose fecha um identificador de objeto.

Sintaxe

NTSYSAPI NTSTATUS ZwClose(
  [in] HANDLE Handle
);

Parâmetros

[in] Handle

Manipule para um objeto de qualquer tipo.

Valor retornado

ZwClose retorna STATUS_SUCCESS com êxito ou o código de erro NTSTATUS apropriado sobre falha. Em particular, ele retornará STATUS_INVALID_HANDLE se Handle não for um identificador válido ou STATUS_HANDLE_NOT_CLOSABLE se o thread de chamada não tiver permissão para fechar o identificador.

Comentários

ZwClose é uma rotina genérica que opera em qualquer tipo de objeto.

Fechar um identificador de objeto aberto faz com que o identificador se torne inválido. O sistema também diminui a contagem de identificadores do objeto e verifica se o objeto pode ser excluído. O sistema não exclui o objeto até que todos os identificadores do objeto sejam fechados e nenhum ponteiro referenciado permaneça.

Um driver deve fechar todos os identificadores abertos assim que o identificador não for mais necessário. As alças de kernel, que são aquelas abertas por um thread do sistema ou especificando o sinalizador OBJ_KERNEL_HANDLE, só podem ser fechadas quando o modo de processador anterior for KernelMode. Esse requisito se aplica tanto aos threads do sistema quanto às rotinas de expedição para IRPs que foram emitidas no modo kernel. (Para obter mais informações sobre o modo de processador anterior, consulte ExGetPreviousMode.) Por exemplo, um identificador que ZwCreateKey retorna a uma rotina DriverEntry não pode ser fechado posteriormente pelas mesmas rotinas de expedição do driver. Uma rotina driverEntry é executada em um processo do sistema, enquanto as rotinas de expedição geralmente são executadas no contexto do thread que emite a solicitação de E/S atual ou, para drivers de nível inferior, em um contexto de thread arbitrário.

Um identificador nãokernel só poderá ser fechado se uma das duas condições for atendida: o modo de processador anterior é KernelMode ou o thread de chamada tem permissão suficiente para fechar o identificador. Um exemplo deste último ocorre quando o thread de chamada é aquele que criou o identificador.

Os chamadores de ZwClose não devem assumir que essa rotina espera automaticamente que todas as E/S sejam concluídas antes de retornar.

Nota Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome "NtClose" em vez de "ZwClose".
Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina Windows Native System Services podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Requisitos

   
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Confira também

Usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateDirectoryObject

ZwCreateFile

ZwCreateKey

ZwOpenKey

ZwOpenSection