Estrutura uSTGMEDIUM (objidl.h)

Representa um identificador de memória global generalizado usado para operações de transferência de dados pelas interfaces IAdviseSink, IDataObject e IOleCache .

Sintaxe

typedef struct tagSTGMEDIUM {
  DWORD    tymed;
  union {
    HBITMAP       hBitmap;
    HMETAFILEPICT hMetaFilePict;
    HENHMETAFILE  hEnhMetaFile;
    HGLOBAL       hGlobal;
    LPOLESTR      lpszFileName;
    IStream       *pstm;
    IStorage      *pstg;
  } DUMMYUNIONNAME;
  IUnknown *pUnkForRelease;
} uSTGMEDIUM;

Membros

tymed

O tipo de mídia de armazenamento. As rotinas de marshaling e unmarshaling usam este valor para determinar qual membro de união foi usado. Esse valor deve ser um dos elementos da enumeração TYMED .

DUMMYUNIONNAME

Identificador, cadeia de caracteres ou ponteiro de interface que o processo de recebimento pode usar para acessar os dados que estão sendo transferidos. Se tymed for TYMED_NULL, o membro do sindicato será indefinido; caso contrário, ele é um dos valores a seguir.

DUMMYUNIONNAME.hBitmap

Identificador de bitmap. O membro tymed é TYMED_GDI.

DUMMYUNIONNAME.hMetaFilePict

Identificador de meta-arquivo. O membro tymed é TYMED_MFPICT.

DUMMYUNIONNAME.hEnhMetaFile

Identificador de meta-arquivo aprimorado. O membro tymed é TYMED_ENHMF.

DUMMYUNIONNAME.hGlobal

Identificador de memória global. O membro tymed é TYMED_HGLOBAL.

DUMMYUNIONNAME.lpszFileName

Ponteiro para o caminho de um arquivo de disco que contém os dados. O membro tymed é TYMED_FILE.

DUMMYUNIONNAME.pstm

Ponteiro para uma interface IStream . O membro tymed é TYMED_ISTREAM.

DUMMYUNIONNAME.pstg

Ponteiro para uma interface IStorage . O membro tymed é TYMED_ISTORAGE.

pUnkForRelease

Ponteiro para uma instância de interface que permite que o processo de envio controle a maneira como o armazenamento é liberado quando o processo de recebimento chama a função ReleaseStgMedium . Se pUnkForRelease for NULL, ReleaseStgMedium usará procedimentos padrão para liberar o armazenamento; caso contrário, ReleaseStgMedium usa a interface IUnknown especificada.

Requisitos

Confira também

FORMATETC

Iadvisesink

Idataobject

IOleCache

Releasestgmedium