Função FltUntagFile (fltkernel.h)

Artigo
02/29/2024

FltUntagFile remove um ponto de nova análise de um arquivo ou diretório.

Sintaxe

NTSTATUS FLTAPI FltUntagFile(
  [in]           PFLT_INSTANCE InitiatingInstance,
  [in]           PFILE_OBJECT  FileObject,
  [in]           ULONG         FileTag,
  [in, optional] GUID          *Guid
);

Parâmetros

[in] InitiatingInstance

Ponteiro de instância opaco para a instância de driver de minifiltro que iniciou essa solicitação de E/S. Esse parâmetro é necessário e não pode ser NULL.

[in] FileObject

Ponteiro para um objeto de arquivo para o arquivo ou diretório do qual o ponto de nova análise deve ser removido. O objeto de arquivo deve ser aberto para acesso FILE_WRITE_DATA. Esse parâmetro é necessário e não pode ser NULL.

[in] FileTag

Marca de ponto de nova análise. A marca especificada nesse parâmetro deve corresponder à marca do ponto de nova análise a ser removido.

[in, optional] Guid

GUID (identificador global exclusivo) que identifica exclusivamente o tipo de ponto de nova análise. Se FileTag não for uma marca da Microsoft, esse parâmetro será necessário e não poderá ser NULL. O GUID especificado nesse parâmetro deve corresponder ao GUID do ponto de nova análise a ser removido.

Retornar valor

FltUntagFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_IO_REPARSE_TAG_MISMATCH	A marca de nova análise especificada pelo chamador não correspondeu à marca do ponto de nova análise a ser excluído. Este é um código de erro.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	O GUID de nova análise especificado pelo chamador não correspondeu ao GUID do ponto de nova análise a ser excluído. Este é um código de erro.