共用方式為


FsRtlInsertExtraCreateParameter 函式 (ntifs.h)

FsRtlInsertExtraCreateParameter 例程會將額外的建立參數 (ECP) 內容結構插入 ECP 清單中。

語法

NTSTATUS FsRtlInsertExtraCreateParameter(
  [in, out] PECP_LIST EcpList,
  [in, out] PVOID     EcpContext
);

參數

[in, out] EcpList

應該新增ecpContext 參數所指向之ECP內容結構的ECP清單結構的指標。

[in, out] EcpContext

要新增至ECP清單的ECP內容結構的指標,由ecpList 參數所指向

傳回值

FsRtlInsertExtraCreateParameter 會傳回下列其中一個 NTSTATUS 值:

傳回碼 描述
STATUS_SUCCESS
指定的 ECP 內容結構已成功插入指定的 ECP 清單中。
STATUS_INVALID_PARAMETER
指定的 ECP 內容結構已存在於指定的 ECP 清單中。 在 ECP 清單插入的內容中,如果 ECP 內容結構包含相同的 GUID 值,則會將兩個 ECP 內容結構視為相同。

言論

FsRtlInsertExtraCreateParameter 例程假設指定的 ECP 內容結構要插入指定的 ECP 清單之前是由 FltAllocateExtraCreateParameter 例程所配置。

插入 ECP 清單的每個 ECP 內容結構都必須有唯一的 GUID 值。 當 ECP 內容結構由 FltAllocateExtraCreateParameter 例程配置時,就會設定這個唯一值。

要求

要求 價值
最低支援的用戶端 從 Windows Vista 開始,即可使用 FltInsertExtraCreateParameter 例程。
目標平臺 普遍
標頭 ntifs.h (include Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx