ReadOnlyEnlistment 函式 (ktmw32.h)

要求將指定的登記轉換成只讀登記。 唯讀登記無法參與交易的結果,而且不會永久記錄以進行復原。

語法

BOOL ReadOnlyEnlistment(
  [in] HANDLE         EnlistmentHandle,
  [in] PLARGE_INTEGER TmVirtualClock
);

參數

[in] EnlistmentHandle

登記的句柄。

[in] TmVirtualClock

為此登記收到的最新虛擬時鐘值。 如果您指定 NULL,則不會變更虛擬時鐘值。 請參閱 LARGE_INTEGER

若要變更虛擬時鐘值,此值必須大於 COMMIT 通知中傳回的目前值。

傳回值

如果函式成功,則傳回非零的值。

如果函式失敗,傳回值為零, (0) 。 若要取得擴充的錯誤資訊,請呼叫 GetLastError 函 式。

下列清單會識別可能的錯誤碼:

備註

如果資源管理員不再需要參與交易而不需要復原交易,它應該先呼叫 ReadOnlyEnlistment ,再關閉登記句柄。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 ktmw32.h
程式庫 Ktmw32.lib
Dll Ktmw32.dll

另請參閱

GetCurrentClockTransactionManager

核心交易管理員函式

ReadOnlyEnlistment