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
Utilisation des versions Nt et Zw des routines des services système natifs