TXFS_QUERY_RM_INFORMATION 구조체(winioctl.h)
[Microsoft는 개발자가 애플리케이션의 요구 사항을 달성하기 위해 대체 수단을 활용하는 것이 좋습니다. TxF가 개발된 많은 시나리오는 더 간단하고 쉽게 사용할 수 있는 기술을 통해 달성할 수 있습니다. 또한 이후 버전의 Microsoft Windows에서는 TxF를 사용하지 못할 수도 있습니다. TxF에 대한 자세한 내용과 대안은 트랜잭션 NTFS 사용에 대한 대안을 참조하세요.]
리소스 관리자(RM)에 대한 정보를 포함합니다.
구문
typedef struct _TXFS_QUERY_RM_INFORMATION {
DWORD BytesRequired;
DWORDLONG TailLsn;
DWORDLONG CurrentLsn;
DWORDLONG ArchiveTailLsn;
DWORDLONG LogContainerSize;
LARGE_INTEGER HighestVirtualClock;
DWORD LogContainerCount;
DWORD LogContainerCountMax;
DWORD LogContainerCountMin;
DWORD LogGrowthIncrement;
DWORD LogAutoShrinkPercentage;
DWORD Flags;
WORD LoggingMode;
WORD Reserved;
DWORD RmState;
DWORDLONG LogCapacity;
DWORDLONG LogFree;
DWORDLONG TopsSize;
DWORDLONG TopsUsed;
DWORDLONG TransactionCount;
DWORDLONG OnePCCount;
DWORDLONG TwoPCCount;
DWORDLONG NumberLogFileFull;
DWORDLONG OldestTransactionAge;
GUID RMName;
DWORD TmLogPathOffset;
} TXFS_QUERY_RM_INFORMATION, *PTXFS_QUERY_RM_INFORMATION;
멤버
BytesRequired
FSCTL_TXFS_QUERY_RM_INFORMATIONERROR_BUFFER_TOO_SMALL 반환하는 경우 이 멤버는 NULL 종료 문자를 포함하여 요청된 정보를 반환하는 데 필요한 최소 바이트 수를 지정합니다.
TailLsn
현재 RM에서 사용하는 가장 오래된 LSN(로그 시퀀스 번호)입니다.
CurrentLsn
RM이 로그에서 가장 최근에 사용한 LSN입니다.
ArchiveTailLsn
로그의 보관 꼬리 LSN입니다.
LogContainerSize
로그 컨테이너의 실제 크기(바이트)입니다.
HighestVirtualClock
로그 레코드와 연결된 가장 높은 타임스탬프입니다.
LogContainerCount
로그 컨테이너 수입니다.
LogContainerCountMax
로그 컨테이너의 최대 수입니다.
LogContainerCountMin
로그에 허용되는 최소 컨테이너 수입니다.
LogGrowthIncrement
로그 크기가 증가하는 양이며, 이는 여러 컨테이너 또는 로그 크기의 백분율입니다. 사용되는 증가 유형은 Flags 멤버에 설정된 플래그에 의해 지정됩니다.
LogAutoShrinkPercentage
자동 축소 정책이 활성화된 경우 이 멤버는 로그에서 허용되는 최대 사용 가능한 공간을 지정합니다. 이 멤버가 0이면 자동 축소 정책이 활성화되지 않습니다.
Flags
이 멤버는 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
플래그가 설정된 경우 RM의 로그는 가능한 한 축소할 수 있습니다. 이 플래그는 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX 함께 사용할 수 없습니다. |
|
LogGrowthIncrement의 값 형식을 나타냅니다. 이 플래그가 설정되면 LogGrowthIncrement 는 여러 컨테이너입니다. 이 플래그는 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT 함께 사용할 수 없습니다. |
|
LogGrowthIncrement의 값 형식을 나타냅니다. 이 플래그가 설정되면 LogGrowthIncrement 는 백분율입니다. 이 플래그는 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS 함께 사용할 수 없습니다. |
|
RM의 로그가 경계 없이 증가할 수 있음을 나타냅니다. 이 플래그는 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN 함께 사용할 수 없습니다. |
|
RM 재설정 플래그의 현재 상태를 나타냅니다. 이 설정이 설정되면 다음에 시작될 때 RM이 다시 설정됩니다. 이 플래그는 보조 RM이 아닌 기본 RM에만 유효합니다. 이 플래그는 TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START 함께 사용할 수 없습니다. |
|
RM 재설정 플래그의 현재 상태를 나타냅니다. 이 설정이 설정되면 다음에 시작될 때 RM이 다시 설정되지 않습니다. 이 플래그는 보조 RM이 아닌 기본 RM에만 유효합니다. 이 플래그는 TXFS_RM_FLAG_RESET_RM_AT_NEXT_START 함께 사용할 수 없습니다. |
|
RM이 시스템 가용성보다 트랜잭션 일관성을 선호한다는 것을 나타냅니다. 이 플래그는 TXFS_RM_FLAG_PREFER_AVAILABILITY 함께 사용할 수 없으며 시스템 볼륨의 기본 RM에서 지원되지 않습니다. |
|
RM이 트랜잭션 일관성보다 시스템 가용성을 선호한다는 것을 나타냅니다. 이 플래그는 TXFS_RM_FLAG_PREFER_CONSISTENCY 함께 사용할 수 없으며 시스템 볼륨의 기본 RM에 의해 강제로 적용됩니다. |
LoggingMode
현재 로깅 모드입니다.
| 값 | 의미 |
|---|---|
|
간단한 로깅이 사용됩니다. |
|
전체 로깅 사용 |
Reserved
예약되어 있습니다.
RmState
RM의 상태입니다. 유효한 값은 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
RM이 아직 시작되지 않았습니다. |
|
RM이 시작됩니다. |
|
RM은 활성 상태이며 트랜잭션을 수락할 준비가 되어 있습니다. |
|
RM이 종료되고 있습니다. |
LogCapacity
로그의 총 용량(바이트)입니다.
LogFree
로그에 없는 바이트 수입니다.
TopsSize
$Tops 파일의 크기(바이트)입니다.
TopsUsed
사용 중인 $Tops 파일의 양(바이트)입니다.
TransactionCount
쿼리가 실행된 당시의 활성 트랜잭션 수입니다.
OnePCCount
이 RM에서 발생한 단일 단계 커밋 작업의 수입니다.
TwoPCCount
이 RM에서 발생한 2단계 커밋 작업의 수입니다.
NumberLogFileFull
이 RM의 로그가 가득 찬 횟수입니다.
OldestTransactionAge
가장 오래된 활성 트랜잭션의 길이(밀리초)입니다.
RMName
이 RM의 이름을 나타내는 GUID 입니다.
TmLogPathOffset
이 구조체의 시작부터 TM 로그에 대한 경로를 포함하는 NULL로 끝나는 유니코드 문자열까지의 오프셋입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | winioctl.h(Windows.h 포함) |