FILE_FS_OBJECTID_INFORMATION 구조체(ntddk.h)

아티클
08/07/2023

FILE_FS_OBJECTID_INFORMATION 구조체는 파일 시스템 볼륨의 개체 ID를 쿼리하거나 설정하는 데 사용됩니다.

구문

typedef struct _FILE_FS_OBJECTID_INFORMATION {
  UCHAR ObjectId[16];
  UCHAR ExtendedInfo[48];
} FILE_FS_OBJECTID_INFORMATION, *PFILE_FS_OBJECTID_INFORMATION;

멤버

ObjectId[16]

디스크의 파일 시스템 볼륨을 식별하는 16 바이트 GUID입니다.

ExtendedInfo[48]

파일 시스템 볼륨에 대한 선택적 추가 호출자 정의 정보를 포함하는 48 바이트 값입니다. 이 확장 정보의 의미는 파일 시스템에 불투명합니다.

설명

이 정보는 다음 방법 중 하나로 쿼리할 수 있습니다.

FltQueryVolumeInformation 또는 ZwQueryVolumeInformationFile을 호출하여 FileFsObjectIdInformation을 FileInformationClass 값으로 전달하고 호출자가 할당한 FILE_FS_OBJECTID_INFORMATION 구조화된 버퍼를 FileInformation 값으로 전달합니다.
주 함수 코드 IRP_MJ_QUERY_VOLUME_INFORMATION 사용하여 IRP를 만듭니다.

이 정보를 쿼리하는 데 특정 액세스 권한이 필요하지 않습니다. 따라서 볼륨 자체 또는 볼륨의 파일 또는 디렉터리에 대한 열린 핸들을 통해 볼륨에 액세스하는 한 이 정보를 사용할 수 있습니다.

이 정보는 다음 방법 중 하나로 설정할 수 있습니다.

FltSetVolumeInformation 또는 ZwSetVolumeInformationFile을 호출하여 FileFsObjectIdInformation을 FileInformationClass 값으로 전달하고 호출자가 할당한 FILE_FS_OBJECTID_INFORMATION 구조화된 버퍼를 FileInformation 값으로 전달합니다.
주 함수 코드 IRP_MJ_SET_VOLUME_INFORMATION 사용하여 IRP를 만듭니다.

이 정보를 설정하려면 볼륨에 대한 FILE_WRITE_DATA 액세스가 필요합니다.

볼륨 개체 ID에 대한 지원은 파일 시스템별입니다. NTFS에서 볼륨 개체 ID는 분산 링크 추적 서비스에서 광범위하게 사용됩니다.

볼륨 개체 ID가 볼륨 GUID와 동일하지 않다는 점에 유의해야 합니다. 볼륨 개체 ID는 파일 시스템에 의해 파일 시스템 볼륨에 할당됩니다. 볼륨 GUID 또는 고유한 볼륨 이름은 파일 시스템 독립적입니다. 볼륨 탑재 관리자가 기본 스토리지 볼륨에 할당합니다.

볼륨의 볼륨 GUID를 얻으려면 Win32 GetVolumeNameForVolumeMountPointW 함수 또는 FltGetVolumeGuidName 루틴을 사용합니다.

FileInformation 매개 변수에서 FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile 또는 ZwSetVolumeInformationFile에 전달된 버퍼의 크기는 적어도 sizeof(FILE_FS_OBJECTID_INFORMATION)여야 합니다.

이 구조체는 LONGLONG(8 바이트) 경계에 맞춰야 합니다.