Struttura STGOPTIONS (coml2api.h)

La struttura STGOPTIONS specifica le funzionalità dell'oggetto di archiviazione, ad esempio le dimensioni del settore, nelle funzioni StgCreateStorageEx e StgOpenStorageEx.

Sintassi

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

Members

usVersion

Specifica la versione della struttura STGOPTIONS . È impostato su STGOPTIONS_VERSION.

Nota Quando usVersion è impostato su 1, è possibile impostare il membro ulSectorSize . Questo è utile quando si crea un file di documentazione di settore di grandi dimensioni. Tuttavia, quando usVersion è impostato su 1, il membro pwcsTemplateFile non può essere usato.

 

In Windows 2000 e versioni successive: STGOPTIONS_VERSION può essere impostato su 1 per la versione 1.

In Windows XP e versioni successive: STGOPTIONS_VERSION può essere impostato su 2 per la versione 2.

Per i sistemi operativi precedenti a Windows 2000: STGOPTIONS_VERSION sarà impostato su 0 per la versione 0.

reserved

Riservato per utilizzi futuri; deve essere zero.

ulSectorSize

Specifica le dimensioni del settore dell'oggetto di archiviazione. Il valore predefinito è 512 byte.

pwcsTemplateFile

Specifica il nome di un file i cui metadati EFS (Encrypted File System) verranno trasferiti a un file di archiviazione strutturato appena creato. Questo membro è valido solo quando viene usato STGFMT_DOCFILE con StgCreateStorageEx.

In Windows XP e versioni successive: Il membro pwcsTemplateFile è valido solo se la versione 2 o successiva viene specificata nel membro usVersion .

Commenti

STGOPTIONS è supportato solo nelle API Unicode.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Intestazione	coml2api.h (include Objbase.h)

Vedi anche

Limiti di implementazione di file composti

StgCreateStorageEx

StgOpenStorageEx