Структура uSTGMEDIUM (objidl.h)

Статья
02/29/2024

Представляет универсальный дескриптор глобальной памяти, используемый для операций передачи данных интерфейсами 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

См. также раздел