Funzione TmReadOnlyEnlistment (wdm.h)
La routine TmReadOnlyEnlistment imposta un elenco specificato da leggere.
Sintassi
NTSTATUS TmReadOnlyEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parametri
[in] Enlistment
Puntatore a un oggetto di inserimento. Il componente può ricevere questo puntatore come input a una routine di callback resourceManagerNotification . In alternativa, il componente può chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto che una chiamata precedente a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment fornito.
[in] TmVirtualClock
Puntatore a un valore di orologio virtuale. Questo parametro è facoltativo e può essere NULL.
Valore restituito
TmReadOnlyEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
La transazione o l'inserimento non è nello stato corretto. Ad esempio, un elenco non può essere di sola lettura se il flag di ENLISTMENT_SUPERIOR è stato specificato in ZwCreateEnlistment. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
La routine TmReadOnlyEnlistment è una versione basata su puntatore della routine ZwReadOnlyEnlistment .
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine Zw Xxx, vedere Uso di routine TmXxx.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive del sistema operativo. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |