COleDataObject::GetFileData

Artikel
02/26/2013

Rufen Sie diese Funktion, um CFile oder CFile- abgeleitetes Objekt und Daten im angegebenen Format in einen Zeiger CFile abzurufen.

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

Parameter

cfFormat
Das Format, in dem Daten zurückgegeben werden sollen.Dieser Parameter kann einer der vordefinierten Zwischenablageformate oder einen Wert sein, der von der Funktion systemeigene Windows RegisterClipboardFormat zurückgegeben werden.
lpFormatEtc
Zeigt auf FORMATETC-Struktur die Beschreibung des Formats, in dem Daten zurückgegeben werden sollen.Erstellen Sie einen Wert für diesen Parameter bereit, wenn Sie zusätzliche Formatinformationen über dem Zwischenablageformat hinaus angeben möchten, das von cfFormat angegeben wird.Wenn es NULL ist, werden die Standardwerte für die anderen Felder in der FORMATETC-Struktur verwendet.

Rückgabewert

Zeiger auf neuen CFile oder zu CFile von abgeleitetes Objekt, das die Daten enthält, wenn erfolgreich; andernfalls NULL.

Hinweise

Je nach Mediums, den die Daten in, der tatsächliche Typ gespeichert werden, der an den Rückgabewert gezeigt wird, wie CFile sein, CSharedFile oder COleStreamFile.

Hinweis
Das CFile-Objekt, das durch den Rückgabewert dieser Funktion zugegriffen wird, wird vom Aufrufer gehören.Es liegt in der Verantwortung des Aufrufers zu delete das CFile-Objekt, und dadurch schließt die die Datei.