uSTGMEDIUM 結構 (objidl.h)

表示 IAdviseSink、 IDataObject 和 IOleCache 介面用於數據傳輸作業的一般化全域記憶體句柄。

語法

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

成員

tymed

儲存媒體的類型。 封送處理 (Marshaling) 和解封送處理 (Unmarshaling) 常式會使用這個值來判斷所使用的等位成員。 這個值必須是 TYMED 列舉的其中一個專案。

DUMMYUNIONNAME

處理、字串或接收進程可用來存取所傳輸數據的介面指標。 如果 tymed 是TYMED_NULL，則聯集成員是未定義的;否則，它是下列其中一個值。

DUMMYUNIONNAME.hBitmap

點陣圖句柄。 tymed成員是TYMED_GDI。

DUMMYUNIONNAME.hMetaFilePict

元檔句柄。 tymed成員是TYMED_MFPICT。

DUMMYUNIONNAME.hEnhMetaFile

增強型元檔句柄。 tymed成員是TYMED_ENHMF。

DUMMYUNIONNAME.hGlobal

全域記憶體句柄。 tymed成員是TYMED_HGLOBAL。

DUMMYUNIONNAME.lpszFileName

包含數據的磁碟檔案路徑指標。 tymed成員是TYMED_FILE。

DUMMYUNIONNAME.pstm

IStream 介面的指標。 tymed成員是TYMED_ISTREAM。

DUMMYUNIONNAME.pstg

IStorage 介面的指標。 tymed成員是TYMED_ISTORAGE。

pUnkForRelease

介面實例的指標，允許傳送進程控制接收進程呼叫 ReleaseStgMedium 函式時釋放記憶體的方式。 如果 pUnkForRelease 為 NULL，ReleaseStgMedium 會使用預設程式來釋放記憶體;否則，ReleaseStgMedium 會使用指定的 IUnknown 介面。

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
標頭	objidl.h

另請參閱

FORMATETC

IAdviseSink

IDataObject

IOleCache

ReleaseStgMedium