Compartilhar via


Função FltUntagFile (fltkernel.h)

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.

Comentários

Os drivers de minifiltro devem usar FltUntagFile em vez de FSCTL_DELETE_REPARSE_POINT para excluir um ponto de nova análise.

Um driver de minifiltro pode definir uma marca de nova análise em um arquivo ou diretório chamando FltTagFile.

Para obter mais informações sobre pontos de nova análise, consulte a documentação do SDK do Microsoft Windows.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Confira também

FLT_TAG_DATA_BUFFER

FSCTL_DELETE_REPARSE_POINT

FSCTL_GET_REPARSE_POINT

FSCTL_SET_REPARSE_POINT

FltTagFile

IsReparseTagMicrosoft

IsReparseTagNameSurrogate