Функция FsRtlGetNextExtraCreateParameter (ntifs.h)

Статья
02/29/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 после структуры контекста ECP CurrentEcpContext . Если currentEcpContext имеет значение NULL, FsRtlGetNextExtraCreateParameter возвращает первую структуру контекста ECP в списке.

[out, optional] NextEcpType

Необязательный параметр, получающий указатель на GUID возвращаемой структуры контекста ECP.

[out] NextEcpContext

Необязательный параметр, получающий указатель на возвращаемую структуру контекста ECP.

[out, optional] NextEcpContextSize

Необязательный параметр, который получает размер в байтах возвращаемой структуры контекста ECP.

Возвращаемое значение

FsRtlGetNextExtraCreateParameter возвращает одно из следующих значений NTSTATUS:

Код возврата	Описание
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter обнаружил структуру контекста ECP в списке EcpList ECP.
STATUS_NOT_FOUND	Список ECP EcpList пуст или CurrentEcpContext является последним ecp в списке (то есть отсутствует следующий элемент списка ECP). Кроме того, nextEcpContext имеет значение NULL , а nextEcpContextSize — нулевое значение.
STATUS_INVALID_PARAMETER	Параметр EcpList имеет значение NULL.

ПодпрограммаFsRtlGetNextExtraCreateParameter обрабатывает список ECP не циклическим образом. То есть, если структура контекста ECP, на которую указывает параметр CurrentEcpContext , является последним элементом в списке ECP, то в списке отсутствует "next" ECP и подпрограмма возвращает STATUS_NOT_FOUND.

Требования

Требование	Значение
Минимальная версия клиента	Подпрограмма FsRtlGetNextExtraCreateParameter доступна начиная с Windows Vista.
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL