Estrutura uSTGMEDIUM (objidl.h)

Artigo
03/05/2024

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