Estructura uSTGMEDIUM (objidl.h)

Artículo
03/16/2023

Representa un identificador de memoria global generalizado utilizado para las operaciones de transferencia de datos por las interfaces IAdviseSink, IDataObject e IOleCache .

Sintaxis

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

Miembros

tymed

Tipo de medio de almacenamiento. Las rutinas de cálculo de referencias y de deserialización utilizan este valor para determinar qué miembro de unión se ha utilizado. Este valor debe ser uno de los elementos de la enumeración TYMED .

DUMMYUNIONNAME

Controlador, cadena o puntero de interfaz que el proceso de recepción puede usar para acceder a los datos que se transfieren. Si tymed es TYMED_NULL, el miembro del sindicato no está definido; de lo contrario, es uno de los siguientes valores.

DUMMYUNIONNAME.hBitmap

Identificador de mapa de bits. El miembro tymed es TYMED_GDI.

DUMMYUNIONNAME.hMetaFilePict

Identificador de metarchivo. El miembro tymed es TYMED_MFPICT.

DUMMYUNIONNAME.hEnhMetaFile

Identificador de metarchivo mejorado. El miembro tymed es TYMED_ENHMF.

DUMMYUNIONNAME.hGlobal

Identificador de memoria global. El miembro tymed es TYMED_HGLOBAL.

DUMMYUNIONNAME.lpszFileName

Puntero a la ruta de acceso de un archivo de disco que contiene los datos. El miembro tymed es TYMED_FILE.

DUMMYUNIONNAME.pstm

Puntero a una interfaz IStream . El miembro tymed es TYMED_ISTREAM.

DUMMYUNIONNAME.pstg

Puntero a una interfaz IStorage . El miembro tymed es TYMED_ISTORAGE.

pUnkForRelease

Puntero a una instancia de interfaz que permite al proceso de envío controlar la forma en que se libera el almacenamiento cuando el proceso receptor llama a la función ReleaseStgMedium . Si pUnkForRelease es NULL, ReleaseStgMedium usa procedimientos predeterminados para liberar el almacenamiento; de lo contrario, ReleaseStgMedium usa la interfaz IUnknown especificada.

Requisitos

Requisito	Value
Cliente mínimo compatible	compilación 20348 de Windows 10
Servidor mínimo compatible	compilación 20348 de Windows 10
Encabezado	objidl.h

Consulte también