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
Uso delle versioni Nt e Zw delle routine native di Servizi di sistema