COleDataObject::GetFileData

Wywołanie tej funkcji do tworzenia CFile lub CFile-uzyskane obiektu i pobierania danych w określonym formacie do CFile wskaźnik.

CFile* GetFileData( 
   CLIPFORMAT cfFormat, 
   LPFORMATETC lpFormatEtc = NULL  
);

Parametry

  • cfFormat
    Format, w którym dane są zwracane.Ten parametr może być jedną z wstępnie zdefiniowane formaty Schowka lub wartość zwracana przez macierzysty Windows RegisterClipboardFormat funkcji.

  • lpFormatEtc
    Wskazuje na FORMATETC struktury opisujące format, w którym dane są zwracane.Podać wartość dla tego parametru, jeśli chcesz określić format dodatkowych informacji poza format schowka określonej przez cfFormat.Jeśli jest NULL, wartości domyślne są używane dla innych pól w FORMATETC struktury.

Wartość zwracana

Wskaźnik do nowych CFile lub CFile-uzyskane obiektu zawierającego dane, jeśli kończy się pomyślnie; w przeciwnym razie NULL.

Uwagi

W zależności od nośnik przechowywania danych w, może być rzeczywisty typ wskazywanej przez wartość zwracana CFile, CSharedFile, lub COleStreamFile.

[!UWAGA]

CFile Wartość zwracana przez tę funkcję dostęp do obiektu jest własnością wywołującego.Obowiązkiem rozmówcy na usunąćCFile obiektu, tym samym zamykania pliku.

Aby uzyskać więcej informacji, zobacz FORMATETC w Windows SDK.

Aby uzyskać więcej informacji, zobacz RegisterClipboardFormat w Windows SDK.

Wymagania

Nagłówek: afxole.h

Zobacz też

Informacje

Klasa COleDataObject

Diagram hierarchii

COleDataObject::GetData

COleDataObject::GetGlobalData

COleDataObject::IsDataAvailable