Structure STGOPTIONS (coml2api.h)

Article
03/01/2024

La structure STGOPTIONS spécifie les fonctionnalités de l’objet de stockage, telles que la taille du secteur, dans les fonctions StgCreateStorageEx et StgOpenStorageEx .

Syntaxe

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

Membres

usVersion

Spécifie la version de la structure STGOPTIONS . Il est défini sur STGOPTIONS_VERSION.

Note Lorsque usVersion a la valeur 1, le membre ulSectorSize peut être défini. Cela est utile lors de la création d’un fichier de documentation grand secteur. Toutefois, lorsque usVersion a la valeur 1, le membre pwcsTemplateFile ne peut pas être utilisé.

Dans Windows 2000 et versions ultérieures : STGOPTIONS_VERSION peut être défini sur 1 pour la version 1.

Dans Windows XP et versions ultérieures : STGOPTIONS_VERSION pouvez être défini sur 2 pour la version 2.

Pour les systèmes d’exploitation antérieurs à Windows 2000 : STGOPTIONS_VERSION sera défini sur 0 pour la version 0.

reserved

Réservé pour une future utilisation ; doit être nul.

ulSectorSize

Spécifie la taille de secteur de l’objet de stockage. La valeur par défaut est de 512 octets.

pwcsTemplateFile

Spécifie le nom d’un fichier dont les métadonnées EFS (Encrypted File System) seront transférées vers un fichier de stockage structuré nouvellement créé. Ce membre n’est valide que lorsque STGFMT_DOCFILE est utilisé avec StgCreateStorageEx.

Dans Windows XP et versions ultérieures : Le membre pwcsTemplateFile n’est valide que si la version 2 ou ultérieure est spécifiée dans le membre usVersion .

Remarques

STGOPTIONS est uniquement pris en charge sur les API Unicode.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
En-tête	coml2api.h (inclure Objbase.h)

Voir aussi

Limites d’implémentation de fichiers composés

StgCreateStorageEx

StgOpenStorageEx

Partager via