Compartilhar via


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

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Cabeçalho objidl.h

Confira também

FORMATETC

Iadvisesink

Idataobject

IOleCache

Releasestgmedium