FsRtlGetNextExtraCreateParameter 函式（ntifs.h）

發行項
12/21/2024

FsRtlGetNextExtraCreateParameter 例程會傳回指定 ECP 清單中的下一個（或第一個）額外建立參數（ECP）內容結構的指標。

語法

NTSTATUS FsRtlGetNextExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in, optional]  PVOID     CurrentEcpContext,
  [out, optional] LPGUID    NextEcpType,
  [out]           PVOID     *NextEcpContext,
  [out, optional] ULONG     *NextEcpContextSize
);

參數

[in] EcpList

要檢查之 ECP 清單的指標。

[in, optional] CurrentEcpContext

指定 ECP 清單中 ECP 內容結構的選擇性指標。如果存在，FsRtlGetNextExtraCreateParameter 傳回 ECP 指標後，CurrentEcpContext ECP 內容結構。如果 currentEcpContext NULL，FsRtlGetNextExtraCreateParameter 會傳回清單中的第一個 ECP 內容結構。

[out, optional] NextEcpType

選擇性參數，接收所傳回 ECP 內容結構的 GUID 指標。

[out] NextEcpContext

選擇性參數，接收傳回之 ECP 內容結構的指標。

[out, optional] NextEcpContextSize

選擇性參數，接收所傳回 ECP 內容結構的大小，以位元組為單位。

傳回值

FsRtlGetNextExtraCreateParameter 會傳回下列其中一個 NTSTATUS 值：

傳回碼	描述
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter 在 ecpList ECP 清單中找到 ECP 內容結構。
STATUS_NOT_FOUND	EcpList ECP 清單是空的，或 CurrentEcpContext 是清單中最後一個 ECP（也就是沒有下一個 ECP 清單元素）。此外，NextEcpContext 會設定為 NULL，而 NextEcpContextSize 設定為零。
STATUS_INVALID_PARAMETER	EcpList 參數 NULL。

言論

FsRtlGetNextExtraCreateParameter 例程會以非迴圈方式處理 ECP 清單。也就是說，如果 CurrentEcpContext 參數所指向的 ECP 內容結構是 ECP 清單中的最後一個專案，則清單中沒有 “next” ECP，而例程會傳回STATUS_NOT_FOUND。

要求

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