uSTGMEDIUM-Struktur (objidl.h)

Artikel
02/29/2024

Stellt ein generalisiertes globales Speicherhandle dar, das für Datenübertragungsvorgänge von den Schnittstellen IAdviseSink, IDataObject und IOleCache verwendet wird.

Syntax

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

Member

tymed

Der Typ des Speichermediums. Die Routinen für das Marshalling und Unmarshalling verwenden diesen Wert, um das verwendete Union-Element zu bestimmen. Dieser Wert muss eines der Elemente der TYMED-Enumeration sein.

DUMMYUNIONNAME

Handle, String oder Schnittstellenzeiger, den der empfangende Prozess verwenden kann, um auf die übertragenen Daten zuzugreifen. Wenn tymed TYMED_NULL ist, ist das Gewerkschaftsmitglied nicht definiert; Andernfalls handelt es sich um einen der folgenden Werte.

DUMMYUNIONNAME.hBitmap

Bitmaphandle. Das tymed-Element ist TYMED_GDI.

DUMMYUNIONNAME.hMetaFilePict

Metadateihandle. Das tymed-Element ist TYMED_MFPICT.

DUMMYUNIONNAME.hEnhMetaFile

Erweitertes Metadateihandle. Das tymed-Element ist TYMED_ENHMF.

DUMMYUNIONNAME.hGlobal

Globales Speicherhandle. Das tymed-Element ist TYMED_HGLOBAL.

DUMMYUNIONNAME.lpszFileName

Zeiger auf den Pfad einer Datenträgerdatei, die die Daten enthält. Das tymed-Element ist TYMED_FILE.

DUMMYUNIONNAME.pstm

Zeiger auf eine IStream-Schnittstelle . Das tymed-Element ist TYMED_ISTREAM.

DUMMYUNIONNAME.pstg

Zeiger auf eine IStorage-Schnittstelle . Das tymed-Element ist TYMED_ISTORAGE.

pUnkForRelease

Zeiger auf eine Schnittstelle instance, mit der der sendende Prozess steuern kann, wie der Speicher freigegeben wird, wenn der empfangende Prozess die ReleaseStgMedium-Funktion aufruft. Wenn pUnkForReleaseNULL ist, verwendet ReleaseStgMedium Standardprozeduren, um den Speicher freizugeben. Andernfalls verwendet ReleaseStgMedium die angegebene IUnknown-Schnittstelle.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Kopfzeile	objidl.h

Weitere Informationen