struktur uSTGMEDIUM (objidl.h)

Artikel
03/16/2023

Mewakili handel memori global umum yang digunakan untuk operasi transfer data oleh antarmuka IAdviseSink, IDataObject, dan IOleCache .

Sintaks

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

Anggota

tymed

Jenis media penyimpanan. Rutinitas marshaling dan unmarshaling menggunakan nilai ini untuk menentukan anggota serikat mana yang digunakan. Nilai ini harus menjadi salah satu elemen enumerasi TYMED .

DUMMYUNIONNAME

Menangani, string, atau penunjuk antarmuka yang dapat digunakan proses penerimaan untuk mengakses data yang ditransfer. Jika tymed TYMED_NULL, anggota serikat tidak terdefinisi; jika tidak, ini adalah salah satu nilai berikut.

DUMMYUNIONNAME.hBitmap

Handel bitmap. Anggota tymed adalah TYMED_GDI.

DUMMYUNIONNAME.hMetaFilePict

Handel metafile. Anggota tymed adalah TYMED_MFPICT.

DUMMYUNIONNAME.hEnhMetaFile

Handel metafile yang disempurnakan. Anggota tymed adalah TYMED_ENHMF.

DUMMYUNIONNAME.hGlobal

Handel memori global. Anggota tymed adalah TYMED_HGLOBAL.

DUMMYUNIONNAME.lpszFileName

Penunjuk ke jalur file disk yang berisi data. Anggota tymed adalah TYMED_FILE.

DUMMYUNIONNAME.pstm

Penunjuk ke antarmuka IStream . Anggota tymed adalah TYMED_ISTREAM.

DUMMYUNIONNAME.pstg

Penunjuk ke antarmuka IStorage . Anggota tymed adalah TYMED_ISTORAGE.

pUnkForRelease

Penunjuk ke instans antarmuka yang memungkinkan proses pengiriman mengontrol cara penyimpanan dirilis saat proses penerima memanggil fungsi ReleaseStgMedium . Jika pUnkForRelease adalah NULL, ReleaseStgMedium menggunakan prosedur default untuk merilis penyimpanan; jika tidak, ReleaseStgMedium menggunakan antarmuka IUnknown yang ditentukan.