ZwMakeTemporaryObject, fonction (wdm.h)

La routine ZwMakeTemporaryObject modifie les attributs d’un objet pour le rendre temporaire.

Syntaxe

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Paramètres

[in] Handle

Gérez un objet de n’importe quel type.

Valeur retournée

ZwMakeTemporaryObject retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur NTSTATUS approprié en cas d’échec.

Remarques

ZwMakeTemporaryObject est une routine générique qui fonctionne sur n’importe quel type d’objet.

Un objet est permanent s’il a été créé avec l’attribut d’objet OBJ_PERMANENT spécifié. (Pour plus d’informations sur les attributs d’objet, consultez InitializeObjectAttributes.) Un objet permanent est créé avec un nombre de références de 1. Il n’est donc pas supprimé lorsqu’un pilote le déréférence.

Un objet est temporaire s’il n’est pas permanent. ZwMakeTemporaryObject transforme l’objet spécifié en objet temporaire. Si l’objet est déjà temporaire, cette routine ne fait rien.

Un objet temporaire a un nom uniquement tant que son nombre de handles est supérieur à zéro. Lorsque le nombre de handles atteint zéro, le système supprime le nom de l’objet et ajuste correctement le nombre de pointeurs de l’objet.

Si l’appel à cette fonction se produit en mode utilisateur, vous devez utiliser le nom « NtMakeTemporaryObject » au lieu de « ZwMakeTemporaryObject ».

Pour les appels provenant de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Using Nt and Zw Versions of the Native System Services Routines.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Voir aussi

InitializeObjectAttributes

Utilisation des versions Nt et Zw des routines des services système natifs

ZwClose

ZwCreateDirectoryObject

ZwCreateFile