Função ZwMakeTemporaryObject (wdm.h)
A rotina ZwMakeTemporaryObject altera os atributos de um objeto para torná-lo temporário.
Sintaxe
NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
[in] HANDLE Handle
);
Parâmetros
[in] Handle
Manipule para um objeto de qualquer tipo.
Retornar valor
ZwMakeTemporaryObject retorna STATUS_SUCCESS com êxito ou o código de erro NTSTATUS apropriado em caso de falha.
Comentários
ZwMakeTemporaryObject é uma rotina genérica que opera em qualquer tipo de objeto.
Um objeto será permanente se tiver sido criado com o atributo de objeto OBJ_PERMANENT especificado. (Para obter mais informações sobre atributos de objeto, consulte InitializeObjectAttributes.) Um objeto permanente é criado com uma contagem de referência de 1, portanto, ele não é excluído quando um driver o desreferencia.
Um objeto será temporário se não for permanente. ZwMakeTemporaryObject transforma o objeto especificado em um objeto temporário. Se o objeto já for temporário, essa rotina não fará nada.
Um objeto temporário tem um nome apenas desde que sua contagem de identificadores seja maior que zero. Quando a contagem de identificadores atinge zero, o sistema exclui o nome do objeto e ajusta adequadamente a contagem de ponteiros do objeto.
Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome "NtMakeTemporaryObject" em vez de "ZwMakeTemporaryObject".
Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows 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 dos Serviços de Sistema Nativo.
Requisitos
| Requisito | Valor |
|---|---|
| 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), PowerIrpDDis(wdm) |
Confira também
Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo