STGOPTIONS-Struktur (coml2api.h)

Die STGOPTIONS-Struktur gibt Features des Speicherobjekts an, z. B. die Sektorgröße, in den Funktionen StgCreateStorageEx und StgOpenStorageEx .

Syntax

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

Member

usVersion

Gibt die Version der STGOPTIONS-Struktur an. Es ist auf STGOPTIONS_VERSION festgelegt.

Hinweis Wenn usVersion auf 1 festgelegt ist, kann der ulSectorSize-Member festgelegt werden. Dies ist nützlich beim Erstellen einer umfangreichen Dokumentationsdatei. Wenn usVersion jedoch auf 1 festgelegt ist, kann das element pwcsTemplateFile nicht verwendet werden.

 

In Windows 2000 und höher: STGOPTIONS_VERSION kann für Version 1 auf 1 festgelegt werden.

In Windows XP und höher: STGOPTIONS_VERSION kann für Version 2 auf 2 festgelegt werden.

Für Betriebssysteme vor Windows 2000: STGOPTIONS_VERSION wird für Version 0 auf 0 festgelegt.

reserved

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

ulSectorSize

Gibt die Sektorgröße des Speicherobjekts an. Der Standardwert ist 512 Bytes.

pwcsTemplateFile

Gibt den Namen einer Datei an, deren EFS-Metadaten (Encrypted File System) in eine neu erstellte Strukturierte Speicherdatei übertragen werden. Dieser Member ist nur gültig, wenn STGFMT_DOCFILE mit StgCreateStorageEx verwendet wird.

In Windows XP und höher: Das pwcsTemplateFile-Element ist nur gültig, wenn Version 2 oder höher im usVersion-Member angegeben ist.

Hinweise

STGOPTIONS wird nur für Unicode-APIs unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Kopfzeile	coml2api.h (include Objbase.h)

Weitere Informationen

Implementierungsgrenzwerte für zusammengesetzte Dateien

StgCreateStorageEx

StgOpenStorageEx