COleDataSource::OnSetData

Artykuł
02/27/2013

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*.*