STGMEDIUM

9/8/2008

Essa estrutura descreve uma mídia de transferir para objetos dados.

Syntax

typedef struct tagSTGMEDIUM {
  unsigned long tymed;
  union {
    HBITMAP hBitmap;
    HMETAFILEPICT hMetaFilePict;
    HENHMETAFILE hEnhMetaFile;
    HGLOBAL hGlobal;
    LPOLESTR lpszFileName;
    Istream* pstm;
    IStorage* pstg;
  }u;
  IUnknown* pUnkForRelease; 
} uSTGMEDIUM;

Os membros

• tymed
  Tipo de meio de armazenamento.

  O empacotamento e desempacotamento rotinas usam esse valor para determinar qual união membro foi usado.

  Este valor deve ser um dos elementos da TYMED enumeração.

• união membro
  Uma união contendo um identificador, seqüência de caracteres ou ponteiro interface que o processo de recebimento pode usar para acessar os dados que estão sendo transferidos.

  Se tymed é TYMED_NULL, a união membro é indefinido.

• hBitmap
  Identificador para um bitmap.

  O tymed membro é TYMED_GDI.

• hMetaFilePict
  Identificador para um metarquivo.

  O tymed membro é TYMED_MFPICT.

• hEnhMetaFile
  Identificador para um metarquivo avançado.

  O tymed membro é TYMED_ENHMF.

• hGlobal
  Identificador memória global.

  O tymed membro é TYMED_HGLOBAL.

• lpszFileName
  Ponteiro longo para o seqüência de caracteres NULL-Terminated que contém o caminho de uma arquivo em disco que contém os dados.

  O tymed membro é TYMED_FILE.

• pstm
  Ponteiro para um IStream interface.

  O tymed membro é TYMED_ISTREAM.

• pstg
  Ponteiro para um IStorage interface.

  O tymed membro é TYMED_ISTORAGE.

• pUnkForRelease
  Ponteiro para uma instância interface que permite que o processo de envio para controle a maneira como o armazenamento é liberado quando o processo de recebimento chama o ReleaseStgMedium função.

  Se pUnkForRelease é NULL, ReleaseStgMedium usa procedimentos usar como padrão para versão de armazenamento; caso contrário, ReleaseStgMedium Usa o especificado IUnknown interface.

Remarks

O seqüência de caracteres você transmitir in a lpszFileName membro deve ser alocado usando um GlobalAlloc Ou malloc.

Requirements

Header	objidl.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

TYMED