coml2api.h (STGOPTIONS 結構)

  • 發行項

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 和更新版本中： STGOPTIONS_VERSION 可以針對第 1 版設定為 1。

在 Windows XP 和更新版本中： STGOPTIONS_VERSION 可以針對第 2 版設定為 2。

針對 Windows 2000 之前的作業系統： STGOPTIONS_VERSION 版本 0 會設定為 0。

reserved

保留以備將來之用；必須為零。

ulSectorSize

指定儲存物件的扇區大小。 預設值為 512 個字節。

pwcsTemplateFile

指定檔案的名稱，其加密文件系統 (EFS) 元數據將會傳送至新建立的結構化記憶體檔案。 只有當 STGFMT_DOCFILE 與 StgCreateStorageEx 搭配使用時，此成員才有效。

在 Windows XP 和更新版本中： pwcsTemplateFile 成員只有在 usVersion 成員中指定第 2 版或更新版本時才有效。

備註

只有 Unicode API 才支援 STGOPTIONS。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
標頭 coml2api.h (包含 Objbase.h)

另請參閱

複合檔案實作限制

StgCreateStorageEx

StgOpenStorageEx