OleCreateLink 関数 (ole2.h)

OLE 複合ドキュメントリンク オブジェクトを作成します。

構文

HRESULT OleCreateLink(
  [in]  LPMONIKER       pmkLinkSrc,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

パラメーター

[in] pmkLinkSrc

モニカー上の IMoniker インターフェイスへのポインター。リンク されたオブジェクトのソースの検索に使用できます。

[in] riid

呼び出し元が後で使用して新しいオブジェクトとの通信に使用するインターフェイスの識別子への参照 (通常は、 IOleObject のインターフェイス識別子として OLE ヘッダーで定義されているIID_IOleObject)。

[in] renderopt

列挙 OLERENDER の値を指定します。この値は、新しく作成されたオブジェクトが持つローカル にキャッシュされた図面またはデータ取得機能を示します。 その他の考慮事項については、後述の「備考」セクションを参照してください。

[in] lpFormatEtc

新しく作成されたオブジェクトが持つローカル にキャッシュされた描画またはデータ取得機能を示す列挙 OLERENDER からの値へのポインター。 選択した OLERENDER 値は、 lpFormatEtc パラメーターに使用できる値に影響します。

[in] pClientSite

オブジェクトがコンテナーからサービスを要求するプライマリ インターフェイスである IOleClientSite のインスタンスへのポインター。 このパラメーターは、NULL でもかまいません。

[in] pStg

ストレージ オブジェクトの IStorage インターフェイスへのポインター。 このパラメーターを NULL にすることはできません。

[out] ppvObj

riid で要求されたインターフェイス ポインターを受け取るポインター変数のアドレス。 正常に戻ると、*ppvObj には、新しく作成されたオブジェクトに要求されたインターフェイス ポインターが含まれます。

戻り値

この関数は、成功したS_OKを返します。 その他の使用可能な値は次のとおりです。

リターン コード 説明
OLE_E_CANT_BINDTOSOURCE
ソースにバインドできません。

解説

OleCreateLink を呼び出して、コンテナーがオブジェクトへのリンクを作成できるようにします。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ole2.h
Library Ole32.lib
[DLL] Ole32.dll

関連項目

IOleClientSite::GetMoniker

IOleObject::SetMoniker