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

留待将来使用；必须为零。

ulSectorSize

指定存储对象的扇区大小。 默认值为 512 字节。

pwcsTemplateFile

指定其加密文件系统 (EFS) 元数据将传输到新创建的结构化存储文件的文件的名称。 仅当 STGFMT_DOCFILE 与 StgCreateStorageEx 一起使用时，此成员才有效。

在 Windows XP 及更高版本中： 仅当 usVersion 成员中指定了版本 2 或更高版本时，pwcsTemplateFile 成员才有效。

注解

STGOPTIONS 仅在 Unicode API 上受支持。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
标头 coml2api.h (包括 Objbase.h)

另请参阅

复合文件实现限制

StgCreateStorageEx

StgOpenStorageEx