COleClientItem::CreateLinkFromFile

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ファイルを使って OLE リンクアイテムを作成します。

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

パラメータ

lpszFileName
OLE アイテムを作成するのに使われるファイル名へのポインタ。
render
サーバーが OLE アイテムを描画する方法を指定するフラグ。指定する値については、Windows SDK の「OLERENDER」を参照してください。
cfFormat
OLE アイテムの作成時にキャッシュされるクリップボードデータの形式。
lpFormatEtc
render が OLERENDER_FORMAT または OLERENDER_DRAW のときに使用される FORMATETC 構造体へのポインタ。cfFormat で指定されたクリップボード形式に対して付加形式情報を指定する場合だけ、このパラメータを指定します。このパラメータを省略すると、FORMATETC 構造体のほかのフィールドには既定の値が使われます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ユーザーが [オブジェクトの挿入] ダイアログボックスで、[ファイルから作成] をクリックし、[リンク] チェックボックスをオンにしているときに [OK] をクリックすると、フレームワークはこの関数を呼び出します。これは COleInsertDialog::CreateItem から呼び出されます。

詳細については、Windows SDK の「OleCreateLinkToFile」、「OLERENDER」および「FORMATETC」を参照してください。