Поделиться через


Структура 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

Тип носителя хранилища. Процедура маршалинга и процедура распаковки используют это значение, чтобы определить, какой элемент объединения использовался. Это значение должно быть одним из элементов перечисления 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_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