COleDataSource::OnSetData

Articolo
02/19/2013

Chiamato dal framework per impostare o sostituire i dati nell'oggetto COleDataSource il formato specificato.

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

Parametri

lpFormatEtc
Punta alla struttura FORMATETC che specifica il formato in cui i dati vengono sostituire.
lpStgMedium
Punta alla struttura STGMEDIUM che contiene i dati che sostituiranno i il contenuto corrente COleDataSource oggetto.
bRelease
Indica che dispone di proprietà del supporto di archiviazione dopo il completamento della chiamata di funzione.Il chiamante decide che è responsabile del rilascio delle risorse allocate per conto del supporto di archiviazione.Il chiamante questa operazione impostando bRelease.Se bRelease è diverso da zero, l'origine dati utilizza la proprietà, liberando il supporto quando è stata completata utilizzando.Quando bRelease è 0, il chiamante deve mantenere la proprietà e l'origine dati può utilizzare il supporto di archiviazione solo per la durata della chiamata.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

L'origine dati non accetta la proprietà dei dati correttamente finché non si sia ottenuta.Ovvero non ha la proprietà se restituisce 0 OnSetData.Se l'origine dati utilizza la proprietà, disponibile il supporto di archiviazione chiamando la funzione ReleaseStgMedium.

L'implementazione predefinita non esegue alcuna operazione.Eseguire l'override di questa funzione per sostituire i dati nel formato specificato.Si tratta di un sottoponibile a override avanzato.

Per ulteriori informazioni, vedere le strutture FORMATETC e STGMEDIUM e le funzioni IDataObject::GetData e ReleaseStgMedium in Windows SDK*.*