Partager via


COleServerItem::OnSetData

Appelé par l'infrastructure pour remplacer les données OLE de l'élément par les données spécifiées.

virtual BOOL OnSetData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium,
   BOOL bRelease 
);

Paramètres

  • lpFormatEtc
    Pointeur vers une structure de FORMATETC spécifiant le format des données.

  • lpStgMedium
    Pointeur vers une structure de STGMEDIUM dans laquelle les données résident.

  • bRelease
    Indique qui possède la propriété du support de stockage après avoir terminé l'appel de fonction.L'appelant décide chargé de libérer les ressources allouées au nom de le support de stockage.L'appelant le fait en définissant bRelease.Si bRelease est différent de zéro, l'élément du serveur utilise la propriété, libérant la prise en charge lorsqu'il a terminé de l'utiliser.Lorsque bRelease est 0, l'appelant conserve la propriété et l'élément du serveur peut utiliser le support de stockage uniquement pour la durée de l'appel.

Valeur de retour

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

Notes

L'élément du serveur ne prend pas en charge la propriété des données jusqu'à ce qu'il soit correctement obtenue.Autrement dit, il ne prend pas en charge la propriété s'il retourne 0.Si la source de données prend la propriété, il libère le support de stockage en appelant la fonction de ReleaseStgMedium .

L'implémentation par défaut n'exécute aucune opération.Remplacez cette fonction pour remplacer les données OLE de l'élément par les données spécifiées.Il s'agit d'un substituable avancé.

Pour plus d'informations, consultez STGMEDIUM, FORMATETC, et le ReleaseStgMedium 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

COleDataSource::OnSetData