Função FsRtlRemoveExtraCreateParameter (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlRemoveExtraCreateParameter pesquisa uma lista ECP para uma estrutura de contexto ECP e, se encontrada, a desanexa da lista ECP.

Sintaxe

NTSTATUS FsRtlRemoveExtraCreateParameter(
  [in, out]       PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out]           PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

Parâmetros

[in, out] EcpList

Ponteiro para a lista de parâmetros de criação extra (ECP) que contém a estrutura de contexto ECP a ser desanexada da lista fornecida.

[in] EcpType

Ponteiro para um GUID que identifica exclusivamente a estrutura de contexto ECP a ser desanexada da lista.

[out] EcpContext

Ponteiro para a estrutura de contexto ECP desanexada. Se a estrutura de contexto ECP for desanexada com êxito da lista fornecida, esse parâmetro será definido para apontar para a estrutura de contexto ECP desanexada. Se a estrutura de contexto ECP não for encontrada na lista ECP fornecida, esse parâmetro será definido como NULL.

[out, optional] EcpContextSize

Parâmetro opcional que recebe o tamanho da estrutura de contexto ECP desanexada. Se esse parâmetro estiver presente quando a rotina for chamada, o parâmetro receberá o tamanho, em bytes, da estrutura de contexto ECP desanexada. Se a estrutura de contexto ECP fornecida não tiver sido encontrada na lista ECP fornecida, esse parâmetro será indefinido.

Valor de retorno

FsRtlRemoveExtraCreateParameter retorna um código NTSTATUS, como um dos seguintes:

Código de retorno	Descrição
STATUS_SUCCESS	A estrutura de contexto ECP fornecida foi desanexada com êxito da lista ECP fornecida.
STATUS_NOT_FOUND	A estrutura de contexto ECP fornecida não foi encontrada na lista ECP fornecida.

Observações

A rotina FsRtlRemoveExtraCreateParameter pesquisa a lista ECP fornecida pelo parâmetro EcpList para uma estrutura de contexto ECP fornecida pelo parâmetro EcpType . Se a estrutura de contexto ECP existir na lista, FsRtlRemoveExtraCreateParameter desanexar a estrutura da lista, definirá o parâmetro EcpContext para apontar para a estrutura e retornará STATUS_SUCCESS. Se a estrutura de contexto ECP não existir na lista, FsRtlRemoveExtraCreateParameter definirá o parâmetro EcpContext para NULL e retornará STATUS_NOT_FOUND.

Nota

FsRtlRemoveExtraCreateParameter não libera o pool de memória para a estrutura de contexto ECP. Para liberar o pool de memória para a estrutura de contexto ECP, primeiro chame FsRtlRemoveExtraCreateParameter para desanexá-lo da lista e, em seguida, chame a rotina FltFreeExtraCreateParameter para liberar o pool de memória para a estrutura de contexto ECP.

Requisitos

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

FsRtlAllocateExtraCreateParameter

FsRtlAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

Compartilhar via