Partager via


COleServerItem::OnRenderGlobalData

Appelé par l'infrastructure pour récupérer des données dans le format spécifié lorsque le support de stockage spécifié est mémoire globale.

virtual BOOL OnRenderGlobalData(
   LPFORMATETC lpFormatEtc,
   HGLOBAL* phGlobal 
);

Paramètres

  • lpFormatEtc
    Pointe vers la structure de FORMATETC spécifiant le format dans lequel les informations sont demandées.

  • phGlobal
    Indique un handle vers la mémoire globale dans laquelle les données doivent être retournées.Si aucune mémoire a été allouée, ce paramètre peut être NULL.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Le format spécifié est un précédemment défini dans l'objet d' COleDataSource à l'aide de la fonction membre de DelayRenderData pour le rendu différé.L'implémentation par défaut de cette fonction retourne simplement FALSE.

Si phGlobal est NULL, le nouvel HGLOBAL doit être allouée et retourné dans phGlobal.Sinon, HGLOBAL spécifié par phGlobal doit être rempli avec les données.La quantité de données placées dans HGLOBAL ne doit pas dépasser la taille actuelle du bloc de mémoire.En outre, le bloc ne peut pas être réallocation à une plus grande taille.

Il s'agit d'un substituable avancé.Remplacez cette fonction pour fournir les données au format et le support demandés.Selon les données, vous pouvez substituer l'une des autres versions de cette fonction à la place.Si vous souhaitez gérer plusieurs support de stockage, substituez OnRenderData.Si vos données sont dans un fichier, ou sont de taille variable, substituez OnRenderFileData.

Pour plus d'informations, consultez IDataObject::GetData et le FORMATETC dans Kit de développement logiciel Windows.

Configuration requise

Header: afxole.h

Voir aussi

Référence

Classe de COleServerItem

Graphique de la hiérarchie

COleServerItem::OnRenderData