COleDataSource::OnSetData

virtuel BOOL OnSetData ( LPFORMATETC lpFormatEtc, LPSTGMEDIUM lpStgMedium, BOOL bLibère );

Valeur de retour

Différent de zéro en cas de succès ; sinon 0.

Paramètres

lpFormatEtc

Points à la structure FORMATETC spécifiant le format dans lequel des données sont remplacées.

lpStgMedium

Points à la structure STGMEDIUM contenant les données qui remplaceront le contenu actuel de l'objet COleDataSource.

bLibère

Indique qui a la propriété du support de stockage après avoir terminé l'appel de fonction. L'appelant décide qui est chargé de libérer les ressources allouées au nom du support de stockage. L'appelant fait par le paramètre bLibère. Si bLibère est différente de zéro, la source de données prend possession, libérant ainsi le milieu quand il a fini de l'utiliser. Lorsque bLibère est 0, l'appelant conserve la propriété et la source de données peut utiliser le support de stockage uniquement pendant la durée de l'appel.

Remarques

Appelé par le framework pour définir ou remplacer les données dans l'objet COleDataSource dans le format spécifié. La source de données ne prend pas la propriété des données jusqu'à ce qu'elle a obtenu avec succès il. C'est, il ne faut pas de propriété si OnSetData renvoie la valeur 0. Si la source de données prend possession, elle libère le support de stockage en appelant le fonction ReleaseStgMedium.

L'implémentation par défaut ne fait rien. Substituer cette fonction de remplacer les données dans le format spécifié. C'est une avancée overridable.

Pour plus d'informations, consultez la STGMEDIUM et structures FORMATETC et le ReleaseStgMedium et IDataObject::GetData fonctionne dans la OLE 2 de référence du programmeur, Volume 1.

Aperçu COleDataSource |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;COleDataSource::DelaySetData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnRenderGlobalData, COleServerItem::OnSetData

Index