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 在 CurrentEcpContext ECP 上下文结构后返回指向 ECP 的指针。如果 CurrentEcpContextNULL，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 列表中的最后一个元素，列表中没有“下一步”ECP，并且例程返回STATUS_NOT_FOUND。

要求

要求	价值
最低支持的客户端	FsRtlGetNextExtraCreateParameter 例程从 Windows Vista 开始可用。
目标平台	普遍
标头	ntifs.h （include Ntifs.h）
库	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL