Funzione ZwMakeTemporaryObject (wdm.h)

La routine ZwMakeTemporaryObject modifica gli attributi di un oggetto per renderlo temporaneo.

Sintassi

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Parametri

[in] Handle

Handle per un oggetto di qualsiasi tipo.

Valore restituito

ZwMakeTemporaryObject restituisce STATUS_SUCCESS in caso di esito positivo o il codice di errore NTSTATUS appropriato in caso di errore.

Commenti

ZwMakeTemporaryObject è una routine generica che opera su qualsiasi tipo di oggetto.

Un oggetto è permanente se è stato creato con l'attributo dell'oggetto OBJ_PERMANENT specificato. Per altre informazioni sugli attributi dell'oggetto, vedere InitializeObjectAttributes. Un oggetto permanente viene creato con un conteggio dei riferimenti pari a 1, quindi non viene eliminato quando un driver lo dereferenzia.

Un oggetto è temporaneo se non è permanente. ZwMakeTemporaryObject trasforma l'oggetto specificato in un oggetto temporaneo. Se l'oggetto è già temporaneo, questa routine non esegue alcuna operazione.

Un oggetto temporaneo ha un nome solo a condizione che il numero di handle sia maggiore di zero. Quando il numero di handle raggiunge zero, il sistema elimina il nome dell'oggetto e modifica in modo appropriato il conteggio dei puntatori dell'oggetto.

Se la chiamata a questa funzione si verifica in modalità utente, è necessario usare il nome "NtMakeTemporaryObject" anziché "ZwMakeTemporaryObject".

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

InitializeObjectAttributes

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwClose

ZwCreateDirectoryObject

ZwCreateFile