MARK_HANDLE_INFO 구조체(ntifs.h)

MARK_HANDLE_INFO 구조체는 FSCTL_MARK_HANDLE 제어 코드 요청 중에 입력 버퍼로 전달됩니다.

구문

typedef struct _MARK_HANDLE_INFO {
  union {
    ULONG UsnSourceInfo;
    ULONG CopyNumber;
  } DUMMYUNIONNAME;
  ULONG  UsnSourceInfo;
  HANDLE VolumeHandle;
  ULONG  HandleInfo;
} MARK_HANDLE_INFO, *PMARK_HANDLE_INFO;

멤버

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

아래 UsnSourceInfo를 참조하세요.

DUMMYUNIONNAME.CopyNumber

중복 미디어에 있는 파일에서 읽을 때 읽을 파일의 복사본을 식별합니다.

UsnSourceInfo

선택적 USN(업데이트 시퀀스 번호) 원본 정보 플래그입니다. 이러한 값을 설정하려면 VolumeHandle 필드에 볼륨 DASD 핸들을 지정해야 합니다. 다음 값의 조합일 수 있습니다.

플래그	의미
USN_SOURCE_DATA_MANAGEMENT	서비스가 파일의 어떤 부분의 외부 보기를 수정하지 않습니다. 일반적인 경우는 외부 스토리지 간에 데이터를 이동하는 HSM입니다.
USN_SOURCE_AUXILIARY_DATA	서비스는 이 파일을 만든 애플리케이션과 관련하여 파일의 외부 보기를 수정하지 않습니다. 파일에 프라이빗 데이터 스트림을 추가하는 데 사용할 수 있습니다.
USN_SOURCE_REPLICATION_MANAGEMENT	서비스는 복제본(replica) 집합의 다른 멤버에 있는 동일한 파일의 내용과 일치하도록 파일을 수정하고 있습니다.
USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT	복제는 클라우드 또는 서버에서 클라이언트 시스템에서 수행됩니다. 이 값을 설정하려면 볼륨 핸들이 필요하지 않습니다.

VolumeHandle

이 작업에 대한 볼륨 핸들입니다.

HandleInfo

요청을 식별하는 플래그를 포함합니다. 이 필드는 다음 값 중 하나일 수 있습니다.

플래그	의미
MARK_HANDLE_PROTECT_CLUSTERS	핸들을 닫을 때까지 조각 모음(FSCTL_MOVE_FILE)을 허용하지 않습니다.
MARK_HANDLE_TXF_SYSTEM_LOG	이 스트림은 볼륨의 리소스 관리자에 대한 Txf 로그로 사용되고 있습니다. IRP_MN_KERNEL_CALL 사용하여 커널에서 호출해야 합니다. Windows Vista부터 사용할 수 있습니다.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG	이 구성 요소는 더 이상 이 개체를 TxF 로그 파일로 사용하지 않습니다. Windows Vista부터 사용할 수 있습니다.
MARK_HANDLE_REALTIME	UDFS 파일 시스템에서만 지원됩니다. 디바이스가 비디오의 실시간 스트리밍을 수행하도록 표시합니다. Windows 7부터 사용할 수 있습니다.
MARK_HANDLE_NOT_REALTIME	UDFS 파일 시스템에서만 지원됩니다. 디바이스가 더 이상 비디오의 실시간 스트리밍을 수행하지 않도록 표시합니다. Windows 7부터 사용할 수 있습니다.
MARK_HANDLE_CLOUD_SYNC	되지 않는; 이 플래그를 사용하지 마세요.
MARK_HANDLE_READ_COPY	지정된 데이터 복사본에서 데이터를 읽어야 합니다. 저장소 공간 중복 볼륨에 대해서만 지원됩니다. Windows 8 시작합니다.
MARK_HANDLE_NOT_READ_COPY	데이터는 더 이상 특정 복사본에서 읽을 수 없습니다. 저장소 공간 중복 볼륨에 대해서만 지원됩니다. Windows 8 시작합니다.
MARK_HANDLE_FILTER_METADATA	내부 Microsoft용으로만 예약됩니다.
MARK_HANDLE_RETURN_PURGE_FAILURE	메모리 매핑/캐시된 IO를 캐시되지 않은 IO와 혼합하고 캐시되지 않은 IO가 실행되면 시스템은 캐시되지 않은 IO 범위에 대한 메모리 매핑을 제거하려고 시도합니다. 이러한 제거가 실패하면 시스템은 일반적으로 손상된 상태로 이어질 수 있는 호출자에게 오류를 반환하지 않습니다. 이 플래그는 애플리케이션이 이 상황을 더 잘 처리할 수 있도록 지정된 핸들에 대한 제거 오류를 반환하도록 시스템에 지시합니다. Windows 8.1 시작해서 사용할 수 있습니다.
MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION	지정된 파일에서 FRS(파일 복제 서비스) 압축 기능을 사용하지 않도록 설정합니다. Windows 10 버전 1507부터 사용할 수 있습니다.
MARK_HANDLE_ENABLE_USN_SOURCE_ON_PAGING_IO	USN 저널 페이징 쓰기에 대해 지정된 UsnSourceInfo 값을 설정하도록 NTFS에 지시합니다. 일반적으로 이 작업은 지정된 변경된 스레드를 알지 못했기 때문에 쓰기 페이징에서 수행되지 않았습니다. 재정의입니다. 이는 메모리 관리자가 보유하고 있는 FileObject에 이 상태가 연결된 경우에만 작동합니다. Windows 10 버전 1507부터 사용할 수 있습니다.
MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES	이 파일에 쓰기가 허용되지 않음을 시스템에 알릴 수 있습니다. 누군가가 쓰기 액세스를 위해 파일을 열려고 하면 작업이 실패하고 STATUS_ACCESS_DENIED. 쓰기가 표시되는 경우 STATUS_MARKED_TO_DISALLOW_WRITES 작업에서 실패합니다. Windows 10 버전 1507부터 사용할 수 있습니다.
MARK_HANDLE_ENABLE_CPU_CACHE	내부 Microsoft용으로만 예약됩니다.
MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH	일반적으로 볼륨 핸들(DASD 열기)의 첫 번째 읽기/쓰기 작업에서 파일 시스템은 볼륨을 플러시합니다. 이는 특정 시나리오에서 성능에 영향을 미칠 수 있습니다. 이 플래그가 볼륨 핸들에 설정된 경우 첫 번째 IO에서 해당 플러시를 표시하지 않습니다. Windows 11 시작해서 사용할 수 있습니다.

설명

MARK_HANDLE_INFO 지정된 파일 또는 디렉터리를 표시하는 데 사용되는 정보와 변경 내용에 대한 데이터가 포함된 USN(업데이트 시퀀스 번호) 변경 저널 레코드를 포함합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
머리글	ntifs.h

추가 정보

FSCTL_MARK_HANDLE