Partager via


TmReadOnlyEnlistment, fonction (wdm.h)

La routine TmReadOnlyEnlistment définit une inscription spécifiée en lecture seule.

Syntaxe

NTSTATUS TmReadOnlyEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Paramètres

[in] Enlistment

Pointeur vers un objet d’inscription. Votre composant peut recevoir ce pointeur en tant qu’entrée d’une routine de rappel ResourceManagerNotification . Votre composant peut également appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment .

[in] TmVirtualClock

Pointeur vers une valeur d’horloge virtuelle. Ce paramètre est facultatif et peut être NULL.

Valeur retournée

TmReadOnlyEnlistment retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner l’une des valeurs suivantes :

Code de retour Description
STATUS_TRANSACTION_NOT_REQUESTED
La transaction ou son inscription n’est pas dans l’état correct. Par exemple, une inscription ne peut pas être en lecture seule si l’indicateur ENLISTMENT_SUPERIOR a été spécifié à ZwCreateEnlistment.
 

La routine peut retourner d’autres valeurs NTSTATUS.

Remarques

La routine TmReadOnlyEnlistment est une version basée sur des pointeurs de la routine ZwReadOnlyEnlistment .

Pour plus d’informations sur l’utilisation des routines TmXxx de KTM au lieu des routines ZwXxx , consultez Utilisation des routines TmXxx.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures du système d’exploitation.
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

Voir aussi

ObReferenceObjectByHandle

ResourceManagerNotification

TmCreateEnlistment

ZwCreateEnlistment

ZwOpenEnlistment

ZwReadOnlyEnlistment