Função FsRtlInsertExtraCreateParameter (ntifs.h)

O FsRtlInsertExtraCreateParameter rotina insere uma estrutura de contexto ECP (parâmetro de criação extra) em uma lista ECP.

Sintaxe

NTSTATUS FsRtlInsertExtraCreateParameter(
  [in, out] PECP_LIST EcpList,
  [in, out] PVOID     EcpContext
);

Parâmetros

[in, out] EcpList

O ponteiro para a estrutura de lista ECP à qual a estrutura de contexto ECP, apontada pelo parâmetro EcpContext, deve ser adicionada.

[in, out] EcpContext

Ponteiro para a estrutura de contexto ECP a ser adicionada à lista ECP, apontada pelo parâmetro EcpList .

Valor de retorno

FsRtlInsertExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A estrutura de contexto ECP fornecida foi inserida com êxito na lista ECP fornecida.
STATUS_INVALID_PARAMETER	A estrutura de contexto ECP fornecida já existe na lista ECP fornecida. No contexto de inserção de lista ECP, duas estruturas de contexto ECP são consideradas idênticas se contiverem valores guid iguais.

Observações

A rotina FsRtlInsertExtraCreateParameter pressupõe que a estrutura de contexto ECP fornecida a ser inserida na lista ECP fornecida foi alocada anteriormente pela rotina fltAllocateExtraCreateParameter .

Cada estrutura de contexto ECP inserida na lista ECP deve ter um valor GUID exclusivo. Esse valor exclusivo é definido quando a estrutura de contexto ECP é alocada pela rotina FltAllocateExtraCreateParameter.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	A rotina FltInsertExtraCreateParameter 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

FltGetEcpListFromCallbackData

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx