STATSTG Structure

typedef struct tagSTATSTG {
  LPOLESTR       pwcsName;
  DWORD          type;
  ULARGE_INTEGER cbSize;
  FILETIME       mtime;
  FILETIME       ctime;
  FILETIME       atime;
  DWORD          grfMode;
  DWORD          grfLocksSupported;
  CLSID          clsid;
  DWORD          grfStateBits;
  DWORD          reserved;
} STATSTG;

STATSTG 구조체에는 open storage, stream 또는 바이트 배열 객체에 대한 통계 데이터가 포함되어있다.

또한 이 구조체는 IEnumSTATSTG, ILockBytes, IStream 인터페이스에서 사용된다.

 

pwcsName

이름을 포함하는 NULL 종단 유니코드 문자열에 대한 포인터로, 호출자가 호출한 후 해제한 메소드에 의해 할당된다.

이 필드를 반환하지않으려면 STATSTG 구조체를 반환하는 메소드를

호출할때 STATFLAG_NONAME 값을 지정하면된다.

단, IEnumSTATSTG::Next 메소드의 호출에서는 이값을 지정할 수 없다.

 

type

스토리지 객체의 type을 나타내는것으로, STGTY 열거형에서 나온 값 중 하나이다.

 

cbSize

스트림 또는 바이트배열의 바이트 크기를 지정한다.

 

mtime

이 스토리지, 스트림 또는 바이트배열의 마지막 수정 시간을 나타낸다.

 

ctime

이 스토리지, 스트림 또는 바이트배열의 마지막 수정 시간을 나타낸다.

 

atime

이 스토리지, 스트림 또는 바이트배열의 마지막 엑세스 시간을 나타낸다.

 

grfMode

객체를 열 때 지정된 액세스 모드를 나타낸다.이 필드는 Stat 메소드의 호출에서만 유효하다.

 

grfLocksSupported

스트림 또는 바이트 배열에 의해 지원되는 영역 잠금 type 을 나타낸다.
사용 가능한 값에 대한 자세한 내용은 LOCKTYPE 열거형을 참조하면된다.
이 필드는 스토리지 객체에서 사용되지않는다.

 

clsid

스토리지 객체의 클래스 식별자를 나타내며, 새 스토리지 객체에 대해 CLSID_NULL 로 설정된다.이 필드는 스트림이나 바이트 배열에 사용되지않는다.

 

grfStateBits

스토리지 객체에서 IStorage::SetStateBits 메소드에 의해 가장 최근 설정된 상태 비트를 나타낸다.

 

reserved

예약 공간

 

 

 

 

 

 

이 문서는 번역기를 사용하여 번역 및 수정한 문서이므로 오역이 있을 수 있습니다.

댓글로 오역된 부분을 알려주시면 수정하도록 하겠습니다.

 

원본 문서 : https://docs.microsoft.com/en-us/windows/win32/api/objidl/ns-objidl-statstg