Функция 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. Если CurrentEcpContextNULL, FsRtlGetNextExtraCreateParameter возвращает первую структуру контекста ECP в списке.

[out, optional] NextEcpType

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

[out] NextEcpContext

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

[out, optional] NextEcpContextSize

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

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

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

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Подпрограмма FsRtlGetNextExtraCreateParameter доступна начиная с Windows Vista.
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL