NtSetInformationEnlistment 函式 (wdm.h)

ZwSetInformationEnlistment 例程會設定指定登記對象的資訊。

語法

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationEnlistment(
  [in] HANDLE                       EnlistmentHandle,
  [in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [in] PVOID                        EnlistmentInformation,
  [in] ULONG                        EnlistmentInformationLength
);

參數

[in] EnlistmentHandle

前一次呼叫 ZwCreateEnlistment 或 ZwOpenEnlistment 取得的登記物件句柄。 句柄必須具有物件的ENLISTMENT_SET_INFORMATION存取權。

[in] EnlistmentInformationClass

ENLISTMENT_INFORMATION_CLASS型別列舉值，指定要設定的信息類型。 此值必須是 EnlistmentRecoveryInformation。

列舉的 EnlistmentBasicInformation 和 EnlistmentFullInformation 值不會與 ZwSetInformationEnlistment 搭配使用。

[in] EnlistmentInformation

呼叫端配置的緩衝區指標，其中包含登記的呼叫端定義復原資訊。

[in] EnlistmentInformationLength

EnlistmentInformation 參數指向的緩衝區長度，以位元組為單位。

傳回值

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

傳回碼	Description
STATUS_OBJECT_TYPE_MISMATCH	指定的句柄不是登記物件的句柄。
STATUS_INVALID_HANDLE	物件句柄無效。
STATUS_INVALID_INFO_CLASS	EnlistmentInformationClass 參數的值無效。
STATUS_INFO_LENGTH_MISMATCH	EnlistmentInformationLength 參數的值無效。
STATUS_ACCESS_DENIED	呼叫端對登記對象沒有適當的存取權。

 

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

備註

資源管理員可以使用 ZwSetInformationEnlistment 例程來設定登記的復原資訊。 KTM 會將復原資訊寫入記錄數據流，而資源管理員可以呼叫 ZwQueryInformationEnlistment ，隨時從記錄數據流讀取此資訊。

每次對 ZwSetInformationEnlistment 的後續呼叫都會刪除先前呼叫儲存新復原資訊之前所指定的復原資訊。

如需如何使用 ZwSetInformationEnlistment 的詳細資訊，請參閱 搭配 KTM 使用記錄數據流。

NtSetInformationEnlistment 和 ZwSetInformationEnlistment 是相同 Windows 原生系統服務例程的兩個版本。

對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。

規格需求

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

另請參閱

ENLISTMENT_INFORMATION_CLASS

使用原生系統服務例程的 Nt 和 Zw 版本

ZwCreateEnlistment

ZwOpenEnlistment

ZwQueryInformationEnlistment