Função FsRtlGetNextExtraCreateParameter (ntifs.h)

Artigo
08/07/2023

A rotina FsRtlGetNextExtraCreateParameter retorna um ponteiro para a próxima (ou primeira) estrutura de contexto de parâmetro de criação extra (ECP) em uma determinada lista ECP.

Sintaxe

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

Parâmetros

[in] EcpList

Ponteiro para a lista ECP a ser examinada.

[in, optional] CurrentEcpContext

Ponteiro opcional para uma estrutura de contexto ECP na lista ECP fornecida. Se presente, FsRtlGetNextExtraCreateParameter retornará um ponteiro para o ECP após a estrutura de contexto ECP CurrentEcpContext . Se CurrentEcpContext for NULL, FsRtlGetNextExtraCreateParameter retornará a primeira estrutura de contexto ECP na lista.

[out, optional] NextEcpType

Parâmetro opcional que recebe um ponteiro para o GUID da estrutura de contexto ECP retornada.

[out] NextEcpContext

Parâmetro opcional que recebe um ponteiro para a estrutura de contexto ECP retornada.

[out, optional] NextEcpContextSize

Parâmetro opcional que recebe o tamanho, em bytes, da estrutura de contexto ECP retornada.

Retornar valor

FsRtlGetNextExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter encontrou uma estrutura de contexto ECP na lista ECP EcpList .
STATUS_NOT_FOUND	A lista ECP EcpList está vazia ou CurrentEcpContext é o último ECP na lista (ou seja, não há nenhum próximo elemento de lista ECP). Além disso, NextEcpContext é definido como NULL e NextEcpContextSize é definido como zero.
STATUS_INVALID_PARAMETER	O parâmetro EcpList é NULL.

Comentários

A rotinaFsRtlGetNextExtraCreateParameter processa uma lista ECP de maneira não circular. Ou seja, se a estrutura de contexto ECP apontada pelo parâmetro CurrentEcpContext for o último elemento na lista ECP, não haverá nenhum ECP "próximo" na lista e a rotina retornará STATUS_NOT_FOUND.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	A rotina FsRtlGetNextExtraCreateParameter está disponível a partir do Windows Vista.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL