TmReferenceEnlistmentKey 函式 (wdm.h)

TmReferenceEnlistmentKey 例程會遞增指定登記物件索引鍵的參考計數，並擷取索引鍵。

語法

NTSTATUS TmReferenceEnlistmentKey(
  [in]  PKENLISTMENT Enlistment,
  [out] PVOID        *Key
);

[in] Enlistment

登記物件的指標。您的元件可以接收此指標做為 ResourceManagerNotification 回呼例程的輸入。或者，您的元件可以呼叫 ObReferenceObjectByHandle ，並提供先前呼叫 ZwCreateEnlistment、 TmCreateEnlistment 或 ZwOpenEnlistment 的物件句柄。

[out] Key

接收登記物件登記索引鍵之變數的指標。呼叫者會在呼叫 ZwCreateEnlistment 或 TmCreateEnlistment 時指派登記密鑰。

如果作業成功，TmReferenceEnlistmentKey 會傳回STATUS_SUCCESS。否則，此例程可能會傳回下列其中一個值：

傳回碼	Description
STATUS_INVALID_PARAMETER	Key 參數的值是 NULL。
STATUS_UNSUCCESSFUL	指定登記對象的參考計數已遞減為零，因此無法遞增參考計數。
STATUS_INSUFFICIENT_RESOURCES	參考計數在其最大值 (0xFFFFFFFF) 且無法遞增。

例程可能會傳回其他 NTSTATUS值。

TmReferenceEnlistmentKey 例程會遞增登記物件的索引鍵值的參考計數，而TmDereferenceEnlistmentKey例程會遞減計數。

如果資源管理員已定義登記的索引鍵值，則資源管理員會在呼叫 ZwGetNotificationResourceManager 或 KTM 呼叫 ResourceManagerNotification 回呼例程時收到索引鍵值。

當資源管理員正在處理通知時，它可能會使用索引鍵作為暫存記憶體配置的指標，而且可能會使用參考計數來判斷何時應該解除分配記憶體。

如需何時使用 KTM 的 TmXxx 例程而非 Zw Xxx 例程的資訊，請參閱使用 TmXxx例程。

需求	值
最低支援的用戶端	適用於 Windows Vista 和更新版本的作業系統版本。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL