Função ZwMakeTemporaryObject (wdm.h)

  • Artigo

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

InitializeObjectAttributes

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo

ZwClose

ZwCreateDirectoryObject

ZwCreateFile