COleDataObject::GetFileData

Статья
02/20/2013

Эта функция вызывается для создания CFile или производный объект CFile и получать данные в указанном формате в указатель CFile.

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

Параметры

cfFormat
Формат, в котором данные необходимо вернуть.Этот параметр может быть одним из заранее определенных форматов буфера обмена или значений, возвращаемых функцией Windows RegisterClipboardFormat собственного.
lpFormatEtc
Указывает на FORMATETC составляющих описания формат, в котором данные необходимо вернуть.Введите значение параметра, если необходимо определить дополнительные сведения о формате, формате буфера обмена указанным cfFormat.Если это NULL, то используются значения по умолчанию для других полей в структуре FORMATETC.

Возвращаемое значение

Указатель на новый CFile или - CFile производный объект, содержащий данные, если успешно; в противном случае NULL.

Заметки

В зависимости от носитель данные хранятся внутри фактического типа указанного к возвращаемому значению могут быть CFile, CSharedFile или COleStreamFile.

Примечание
Объект CFile доступ к которому осуществляется возвращаемым значением этой функции принадлежит вызывающим объектом.Обязанностью вызывающего объекта в удалить объект CFile, таким образом закрыть файл.