struttura uSTGMEDIUM (objidl.h)

Articolo
08/25/2023

Rappresenta un handle di memoria globale generalizzato usato per le operazioni di trasferimento dei dati dalle interfacce IAdviseSink, IDataObject e IOleCache .

Sintassi

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

Members

tymed

Tipo di supporto di archiviazione. Nelle routine di marshaling e unmarshaling questo valore viene utilizzato per determinare quale membro di union è stato utilizzato. Questo valore deve essere uno degli elementi dell'enumerazione TYMED .

DUMMYUNIONNAME

Gestire, stringa o puntatore dell'interfaccia che il processo di ricezione può usare per accedere ai dati trasferiti. Se tymed è TYMED_NULL, il membro dell'unione non è definito; in caso contrario, è uno dei valori seguenti.

DUMMYUNIONNAME.hBitmap

Handle bitmap. Il membro tymed è TYMED_GDI.

DUMMYUNIONNAME.hMetaFilePict

Handle metafile. Il membro tymed è TYMED_MFPICT.

DUMMYUNIONNAME.hEnhMetaFile

Handle metafile avanzato. Il membro tymed è TYMED_ENHMF.

DUMMYUNIONNAME.hGlobal

Handle di memoria globale. Il membro tymed è TYMED_HGLOBAL.

DUMMYUNIONNAME.lpszFileName

Puntatore al percorso di un file disco contenente i dati. Il membro tymed è TYMED_FILE.

DUMMYUNIONNAME.pstm

Puntatore a un'interfaccia IStream . Il membro tymed è TYMED_ISTREAM.

DUMMYUNIONNAME.pstg

Puntatore a un'interfaccia IStorage . Il membro tymed è TYMED_ISTORAGE.

pUnkForRelease

Puntatore a un'istanza dell'interfaccia che consente al processo di invio di controllare la modalità di rilascio dell'archiviazione quando il processo di ricezione chiama la funzione ReleaseStgMedium . Se pUnkForRelease è NULL, ReleaseStgMedium usa le procedure predefinite per rilasciare l'archiviazione; in caso contrario, ReleaseStgMedium usa l'interfaccia IUnknown specificata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	objidl.h

Vedi anche