Estrutura STGOPTIONS (coml2api.h)

  • Artigo

A estrutura STGOPTIONS especifica recursos do objeto de armazenamento, como o tamanho do setor, nas funções StgCreateStorageEx e StgOpenStorageEx .

Sintaxe

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

Membros

usVersion

Especifica a versão da estrutura STGOPTIONS . Está definido como STGOPTIONS_VERSION.

Nota Quando usVersion é definido como 1, o membro ulSectorSize pode ser definido. Isso é útil ao criar um arquivo de documentação de grande setor. No entanto, quando usVersion é definido como 1, o membro pwcsTemplateFile não pode ser usado.
 
No Windows 2000 e posterior: STGOPTIONS_VERSION pode ser definido como 1 para a versão 1.

No Windows XP e posteriores: STGOPTIONS_VERSION pode ser definido como 2 para a versão 2.

Para sistemas operacionais anteriores ao Windows 2000: STGOPTIONS_VERSION será definido como 0 para a versão 0.

reserved

Reservado para uso futuro; deve ser zero.

ulSectorSize

Especifica o tamanho do setor do objeto de armazenamento. O padrão é 512 bytes.

pwcsTemplateFile

Especifica o nome de um arquivo cujos metadados do EFS (Sistema de Arquivos Criptografados) serão transferidos para um arquivo de Armazenamento Estruturado recém-criado. Esse membro só é válido quando STGFMT_DOCFILE é usado com StgCreateStorageEx.

No Windows XP e posterior: O membro pwcsTemplateFile só será válido se a versão 2 ou posterior for especificada no membro usVersion .

Comentários

O STGOPTIONS só tem suporte em APIs Unicode.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho coml2api.h (inclua Objbase.h)

Confira também

Limites de implementação de arquivos compostos

StgCreateStorageEx

StgOpenStorageEx