Estrutura STATSTG (objidl.h)

  • Artigo

A estrutura STATSTG contém dados estatísticos sobre um objeto de armazenamento aberto, fluxo ou matriz de bytes. Essa estrutura é usada nas interfaces IEnumSTATSTG, ILockBytes, IStorage e IStream .

Sintaxe

typedef struct tagSTATSTG {
  LPOLESTR       pwcsName;
  DWORD          type;
  ULARGE_INTEGER cbSize;
  FILETIME       mtime;
  FILETIME       ctime;
  FILETIME       atime;
  DWORD          grfMode;
  DWORD          grfLocksSupported;
  CLSID          clsid;
  DWORD          grfStateBits;
  DWORD          reserved;
} STATSTG;

Membros

pwcsName

Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome. O espaço para essa cadeia de caracteres é alocado pelo método chamado e liberado pelo chamador (para obter mais informações, consulte CoTaskMemFree). Para não retornar esse membro, especifique o valor STATFLAG_NONAME quando você chamar um método que retorna uma estrutura STATSTG , exceto para chamadas para IEnumSTATSTG::Next, que não fornece nenhuma maneira de especificar esse valor.

type

Indica o tipo de objeto de armazenamento. Esse é um dos valores da enumeração STGTY .

cbSize

Especifica o tamanho, em bytes, da matriz de bytes ou fluxo.

mtime

Indica a hora da última modificação desse armazenamento, fluxo ou matriz de bytes.

ctime

Indica a hora de criação desse armazenamento, fluxo ou matriz de bytes.

atime

Indica a última hora de acesso para essa matriz de armazenamento, fluxo ou bytes.

grfMode

Indica o modo de acesso especificado quando o objeto foi aberto. Esse membro só é válido em chamadas para métodos Stat .

grfLocksSupported

Indica os tipos de bloqueio de região com suporte do fluxo ou da matriz de bytes. Para obter mais informações sobre os valores disponíveis, consulte a enumeração LOCKTYPE . Esse membro não é usado para objetos de armazenamento.

clsid

Indica o identificador de classe para o objeto de armazenamento; definido como CLSID_NULL para novos objetos de armazenamento. Esse membro não é usado para fluxos ou matrizes de bytes.

grfStateBits

Indica os bits de estado atuais do objeto de armazenamento; ou seja, o valor mais recentemente definido pelo método IStorage::SetStateBits . Esse membro não é válido para fluxos ou matrizes de bytes.

reserved

Reservado para uso futuro.

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 objidl.h

Confira também

IStorage::SetElementTimes