STGOPTIONS 구조체(coml2api.h)

STGOPTIONS 구조체는 StgCreateStorageEx 및 StgOpenStorageEx 함수에서 섹터 크기와 같은 스토리지 개체의 기능을 지정합니다.

구문

typedef struct tagSTGOPTIONS {
  USHORT      usVersion;
  USHORT      reserved;
  ULONG       ulSectorSize;
  const WCHAR *pwcsTemplateFile;
} STGOPTIONS;

멤버

usVersion

STGOPTIONS 구조체의 버전을 지정합니다. STGOPTIONS_VERSION 설정됩니다.

참고usVersion 을 1로 설정하면 ulSectorSize 멤버를 설정할 수 있습니다. 이는 대규모 섹터 설명서 파일을 만들 때 유용합니다. 그러나 usVersion 을 1로 설정하면 pwcsTemplateFile 멤버를 사용할 수 없습니다.

 

Windows 2000 이상: 버전 1의 경우 STGOPTIONS_VERSION 1로 설정할 수 있습니다.

Windows XP 이상: 버전 2의 경우 STGOPTIONS_VERSION 2로 설정할 수 있습니다.

Windows 2000 이전 운영 체제의 경우: 버전 0 의 경우 STGOPTIONS_VERSION 0으로 설정됩니다.

reserved

나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.

ulSectorSize

스토리지 개체의 섹터 크기를 지정합니다. 기본값은 512바이트입니다.

pwcsTemplateFile

EFS(암호화된 파일 시스템) 메타데이터를 새로 만든 구조적 스토리지 파일로 전송할 파일의 이름을 지정합니다. 이 멤버는 STGFMT_DOCFILE StgCreateStorageEx와 함께 사용되는 경우에만 유효합니다.

Windows XP 이상에서: pwcsTemplateFile 멤버는 버전 2 이상이 usVersion 멤버에 지정된 경우에만 유효합니다.

설명

STGOPTIONS 는 유니코드 API에서만 지원됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
머리글	coml2api.h(Objbase.h 포함)

추가 정보

복합 파일 구현 제한

StgCreateStorageEx

StgOpenStorageEx