다음을 통해 공유


MARK_HANDLE_INFO32 구조체(winioctl.h)

지정된 파일 또는 디렉터리를 표시하는 데 사용되는 정보 및 변경 내용에 대한 데이터가 있는 USN(업데이트 시퀀스 번호) 변경 저널 레코드를 포함합니다. 이는 64비트 코드에 대해서만 정의되며 32비트 코드에서 보낸 MARK_HANDLE_INFO 구조를 해석하기 위해 존재합니다. FSCTL_MARK_HANDLE IOCTL 제어 코드에서 사용됩니다.

구문

typedef struct _MARK_HANDLE_INFO32 {
  union {
    DWORD UsnSourceInfo;
    DWORD CopyNumber;
  } DUMMYUNIONNAME;
  DWORD  UsnSourceInfo;
  UINT32 VolumeHandle;
  DWORD  HandleInfo;
} MARK_HANDLE_INFO32, *PMARK_HANDLE_INFO32;

멤버

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

DUMMYUNIONNAME.CopyNumber

UsnSourceInfo

변경되는 형식입니다.

작업은 파일을 만든 애플리케이션의 관점에서 외부적으로 파일 또는 디렉터리를 수정하지 않습니다.

스레드가 새 USN 레코드를 작성할 때 스레드가 해당 플래그를 설정하는 경우에만 이전 레코드의 원본 정보 플래그가 계속 존재합니다. 따라서 원본 정보 구조를 사용하면 애플리케이션이 바이러스 백신 필터와 같은 알려진 원본에 의해서만 설정된 USN 레코드를 필터링할 수 있습니다.

다음 값이 정의됩니다.

의미
USN_SOURCE_DATA_MANAGEMENT
0x00000001
이 작업은 운영 체제에서 수행한 파일 또는 디렉터리의 변경 내용에 대한 정보를 제공합니다.

일반적인 용도는 원격 스토리지가 데이터를 외부에서 로컬 스토리지로 이동하는 경우입니다. 원격 스토리지는 계층적 스토리지 관리 소프트웨어입니다. 이러한 이동은 일반적으로 최소한 USN 레코드에 USN_REASON_DATA_OVERWRITE 플래그를 추가합니다. 그러나 데이터는 사용자 관점에서 변경되지 않았습니다. 레코드를 보유하는 USN_RECORD 구조체의 SourceInfo 멤버에서 USN_SOURCE_DATA_MANAGEMENT 기록 작업을 수행하지만 데이터가 변경되지 않은 것을 확인할 수 있습니다.

USN_SOURCE_AUXILIARY_DATA
0x00000002
작업은 파일 또는 디렉터리에 프라이빗 데이터 스트림을 추가합니다.

예를 들어 체크섬 정보를 추가하는 바이러스 탐지기가 있을 수 있습니다. 바이러스 탐지기가 항목을 수정하면 시스템에서 USN 레코드를 생성합니다. USN_SOURCE_AUXILIARY_DATA 수정으로 인해 애플리케이션 데이터가 변경되지 않았음을 나타냅니다.

USN_SOURCE_REPLICATION_MANAGEMENT
0x00000004
작업은 복제된 파일의 콘텐츠를 만들거나 업데이트합니다.

예를 들어 파일 복제 서비스는 복제된 디렉터리에서 파일을 만들거나 업데이트할 때 이 플래그를 설정합니다.

VolumeHandle

파일 또는 디렉터리가 있는 볼륨에 대한 볼륨 핸들입니다. 볼륨 핸들을 가져오는 방법에 대한 자세한 내용은 설명 섹션을 참조하세요.

이 핸들은 이 작업에 대한 권한을 확인하는 데 필요합니다.

호출자에게는 SE_MANAGE_VOLUME_NAME 권한이 있어야 합니다. 자세한 내용은 권한을 참조하세요.

HandleInfo

VolumeHandle 멤버의 핸들 값으로 식별되는 파일 또는 디렉터리에 대한 추가 정보를 지정하는 플래그입니다.

의미
MARK_HANDLE_PROTECT_CLUSTERS
0x00000001
핸들이 닫히기 전까지는 파일을 조각 모음할 수 없는 것으로 표시됩니다.
MARK_HANDLE_TXF_SYSTEM_LOG
0x00000004
핸들이 닫히기 전까지는 파일을 조각 모음할 수 없는 것으로 표시됩니다.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG
0x00000008
핸들이 닫히기 전까지는 파일을 조각 모음할 수 없는 것으로 표시됩니다.
MARK_HANDLE_REALTIME
0x00000020
파일은 실제 파일 형식에 관계없이 실시간 읽기 동작으로 표시됩니다. 이 플래그로 표시된 파일은 버퍼되지 않은 I/O에 대해 열어야 합니다.
MARK_HANDLE_NOT_REALTIME
0x00000040
이전에 MARK_HANDLE_REALTIME 플래그를 사용하여 실시간 읽기 동작으로 표시된 파일은 이 플래그를 사용하여 표시를 해제하여 실시간 동작을 제거할 수 있습니다. 이 플래그로 표시된 파일은 버퍼되지 않은 I/O에 대해 열어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8(64비트만 해당) [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
머리글 winioctl.h(Windows.h 포함)