Função FsRtlGetNextExtraCreateParameter (ntifs.h)

Artigo
12/21/2024

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 estiver presente, FsRtlGetNextExtraCreateParameter retornará um ponteiro para o ECP após a estrutura de contexto CurrentEcpContext ECP. Se CurrentEcpContext for NULL, FsRtlGetNextExtraCreateParameter retornará a primeira estrutura de contexto ECP da 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.

Valor de retorno

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 EcpList ECP está vazia ou CurrentEcpContext é o último ECP da lista (ou seja, não há nenhum próximo elemento de lista ECP). Além disso, NextEcpContext é definido como NULL e NextEcpContextSize está definido como zero.
STATUS_INVALID_PARAMETER	O parâmetro EcpList é NULL.

Observações

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á ECP "próximo" na lista e a rotina retornará STATUS_NOT_FOUND.

Requisitos

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

Consulte também

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

Compartilhar via