Structure uSTGMEDIUM (objidl.h)

Article
03/04/2024

Représente un handle de mémoire global généralisé utilisé pour les opérations de transfert de données par les interfaces IAdviseSink, IDataObject et IOleCache .

Syntaxe

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

Membres

tymed

Type de support de stockage. Les routines de marshaling et d'unmarshaling utilisent cette valeur pour déterminer le membre de l'union qui a été utilisé. Cette valeur doit être l’un des éléments de l’énumération TYMED .

DUMMYUNIONNAME

Handle, chaîne ou pointeur d’interface que le processus de réception peut utiliser pour accéder aux données transférées. S’il est TYMED_NULL, le membre du syndicat n’est pas défini ; sinon, il s’agit de l’une des valeurs suivantes.

DUMMYUNIONNAME.hBitmap

Handle bitmap. Le membre lié est TYMED_GDI.

DUMMYUNIONNAME.hMetaFilePict

Handle de métafichier. Le membre lié est TYMED_MFPICT.

DUMMYUNIONNAME.hEnhMetaFile

Handle de métafichier amélioré. Le membre lié est TYMED_ENHMF.

DUMMYUNIONNAME.hGlobal

Handle de mémoire globale. Le membre lié est TYMED_HGLOBAL.

DUMMYUNIONNAME.lpszFileName

Pointeur vers le chemin d’accès d’un fichier de disque qui contient les données. Le membre lié est TYMED_FILE.

DUMMYUNIONNAME.pstm

Pointeur vers une interface IStream . Le membre lié est TYMED_ISTREAM.

DUMMYUNIONNAME.pstg

Pointeur vers une interface IStorage . Le membre lié est TYMED_ISTORAGE.

pUnkForRelease

Pointeur vers une interface instance qui permet au processus d’envoi de contrôler la façon dont le stockage est libéré lorsque le processus de réception appelle la fonction ReleaseStgMedium. Si pUnkForRelease a la valeur NULL, ReleaseStgMedium utilise des procédures par défaut pour libérer le stockage ; sinon, ReleaseStgMedium utilise l’interface IUnknown spécifiée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	objidl.h

Voir aussi