uSTGMEDIUM 结构 (objidl.h)

表示 IAdviseSinkIDataObjectIOleCache 接口用于数据传输操作的通用全局内存句柄。

语法

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

存储介质的类型。 封送和取消封送例程使用此值来确定所使用的联合成员。 此值必须是 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 函数时控制存储的释放方式。 如果 pUnkForReleaseNULL则 ReleaseStgMedium 使用默认过程来释放存储;否则, ReleaseStgMedium 使用指定的 IUnknown 接口。

要求

要求
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
标头 objidl.h

另请参阅

FORMATETC

IAdviseSink

IDataObject

IOleCache

ReleaseStgMedium