COleClientItem::CreateLinkFromFile

Статья
10/16/2008

Call this function to create a linked OLE item from a file.

BOOL CreateLinkFromFile(
   LPCTSTR lpszFileName,
   OLERENDER render = OLERENDER_DRAW,
   CLIPFORMAT cfFormat = 0,
   LPFORMATETC lpFormatEtc = NULL 
);

Параметры

lpszFileName
Pointer to the name of the file from which the OLE item is to be created.
render
Flag specifying how the server will render the OLE item. For the possible values, see OLERENDER in the Windows SDK.
cfFormat
Specifies the Clipboard data format to be cached when creating the OLE item.
lpFormatEtc
Pointer to a FORMATETC structure used if render is OLERENDER_FORMAT or OLERENDER_DRAW. Provide a value for this parameter only if you want to specify additional format information beyond the Clipboard format specified by cfFormat. If you omit this parameter, default values are used for the other fields in the FORMATETC structure.

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

Nonzero if successful; otherwise 0.

Заметки

The framework calls this function if the user chooses OK from the Insert Object dialog box when the Create from File button is selected and the Link check box is checked. It is called from COleInsertDialog::CreateItem.

For more information, see OleCreateLinkToFile, OLERENDER, and FORMATETC in the Windows SDK.