FltUntagFile 함수(fltkernel.h)

아티클
08/07/2023

FltUntagFile 은 파일 또는 디렉터리에서 재분석 지점을 제거합니다.

구문

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

매개 변수

[in] InitiatingInstance

이 I/O 요청을 시작한 미니필터 드라이버 instance 대한 불투명 instance 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] FileObject

재분석 지점을 제거할 파일 또는 디렉터리에 대한 파일 개체에 대한 포인터입니다. FILE_WRITE_DATA 액세스를 위해 파일 개체를 열어야 합니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] FileTag

점 태그를 다시 분석합니다. 이 매개 변수에 지정된 태그는 제거할 재분석 지점의 태그와 일치해야 합니다.

[in, optional] Guid

재분석 지점의 형식을 고유하게 식별하는 GUID(Globally Unique Identifier)입니다. FileTag가 Microsoft 태그가 아닌 경우 이 매개 변수가 필요하며 NULL일 수 없습니다. 이 매개 변수에 지정된 GUID는 제거할 재분석 지점의 GUID와 일치해야 합니다.

반환 값

FltUntagFile 은 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	설명
STATUS_IO_REPARSE_TAG_MISMATCH	호출자가 지정한 재분석 태그가 삭제할 재분석 지점의 태그와 일치하지 않습니다. 오류 코드입니다.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	호출자가 지정한 재분석 GUID가 삭제할 재분석 지점의 GUID와 일치하지 않습니다. 오류 코드입니다.