Struktur STGOPTIONS (coml2api.h)

Artikel
03/13/2024

Struktur STGOPTIONS menentukan fitur objek penyimpanan, seperti ukuran sektor, dalam fungsi StgCreateStorageEx dan StgOpenStorageEx .

Sintaks

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

Anggota

usVersion

Menentukan versi struktur STGOPTIONS . Ini diatur ke STGOPTIONS_VERSION.

Catatan Ketika usVersion diatur ke 1, anggota ulSectorSize dapat diatur. Ini berguna saat membuat file dokumentasi sektor besar. Namun, ketika usVersion diatur ke 1, anggota pwcsTemplateFile tidak dapat digunakan.

Di Windows 2000 dan yang lebih baru: STGOPTIONS_VERSION dapat diatur ke 1 untuk versi 1.

Di Windows XP dan yang lebih baru: STGOPTIONS_VERSION dapat diatur ke 2 untuk versi 2.

Untuk sistem operasi sebelum Windows 2000: STGOPTIONS_VERSION akan diatur ke 0 untuk versi 0.

reserved

Dicadangkan untuk digunakan di masa mendatang; harus nol.

ulSectorSize

Menentukan ukuran sektor objek penyimpanan. Defaultnya adalah 512 byte.

pwcsTemplateFile

Menentukan nama file yang metadata Sistem File Terenkripsi (EFS) akan ditransfer ke file Penyimpanan Terstruktur yang baru dibuat. Anggota ini hanya berlaku ketika STGFMT_DOCFILE digunakan dengan StgCreateStorageEx.

Di Windows XP dan yang lebih baru: Anggota pwcsTemplateFile hanya valid jika versi 2 atau yang lebih baru ditentukan dalam anggota usVersion .

Keterangan

STGOPTIONS hanya didukung pada API Unicode.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Header	coml2api.h (termasuk Objbase.h)

Lihat juga

Batas Implementasi File Campuran

StgCreateStorageEx

StgOpenStorageEx

Bagikan melalui