COleDataSource::OnSetData

Article
03/04/2013

Appelé par l'infrastructure pour définir ou substituer les données dans COleDataSource objet dans le format spécifié.

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

Paramètres

lpFormatEtc
Les points à structure FORMATETC spécifier le format dans lequel les données sont substituées.
lpStgMedium
Les points à STGMEDIUM structure contenant les données qui remplaceront le contenu actuel de l'objet d' COleDataSource .
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, la source de données prend la propriété, libérant la prise en charge lorsqu'il a terminé son utilisation.Lorsque bRelease est 0, l'appelant conserve la propriété et la source de données 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

La source de données ne prend pas en charge la propriété des données jusqu'à ce qu'elle soit correctement obtenue.Autrement dit, il ne prend pas en charge la propriété si retourne 0 d' OnSetData .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 dans le format spécifié.Il s'agit d'un substituable avancé.

Pour plus d'informations, consultez STGMEDIUM et les structures de FORMATETC et ReleaseStgMedium et IDataObject::GetData s'exécute dans Kit de développement logiciel Windows*.*