COleDataSource::OnSetData
Wywoływany przez lub zamienianie danych w ramach COleDataSource obiektu w określonym formacie.
virtual BOOL OnSetData(
LPFORMATETC lpFormatEtc,
LPSTGMEDIUM lpStgMedium,
BOOL bRelease
);
Parametry
lpFormatEtc
Wskazuje na FORMATETC Struktura określająca format, w którym dane są zastępowane.lpStgMedium
Wskazuje na STGMEDIUM struktury zawierającej dane, który zastąpi bieżącą zawartość COleDataSource obiektu.bRelease
Wskazuje, który ma własności nośnik po zakończeniu wywołania funkcji.Wywołujący decyduje, kto jest odpowiedzialny za zwalniając zasoby przydzielonej nośnik.Wywołujący robi to poprzez ustawienie bRelease.Jeśli bRelease jest niezerowa, źródła danych przejmuje na własność, zwalnianie nośnik po zakończeniu używania go.Gdy bRelease jest 0, wywołujący zachowuje własność i źródła danych można użyć nośnika tylko na czas trwania rozmowy.
Wartość zwracana
Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.
Uwagi
Źródło danych dopiero własności danych została pomyślnie uzyskano go.Oznacza to, że go nie przejąć na własność Jeśli OnSetData zwraca wartość 0.Jeśli źródło danych przejmuje na własność, zwalnia nośnik, wywołując ReleaseStgMedium funkcji.
Domyślna implementacja nic nie robi.Zastąpienie tej funkcji, aby zastąpić dane w określonym formacie.Jest to zaawansowane NotOverridable.
Aby uzyskać więcej informacji, zobacz STGMEDIUM i FORMATETC struktur i ReleaseStgMedium i Metoda IDataObject::GetData funkcje w Windows SDK*.*
Wymagania
Nagłówek: afxole.h
Zobacz też
Informacje
COleDataSource::OnRenderFileData