CreateDataCache 関数 (objbase.h)

  • [アーティクル]

OLE で提供されるデータ キャッシュの実装の新しいインスタンスへのポインターを取得します。

構文

HRESULT CreateDataCache(
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFCLSID  rclsid,
  [in]  REFIID    iid,
  [out] LPVOID    *ppv
);

パラメーター

[in] pUnkOuter

キャッシュを集計の一部として作成する場合は、集計の制御する IUnknown へのポインター。 そうでない場合、パラメーターは NULL である必要があります。

[in] rclsid

アイコン ラベルの生成に使用される CLSID。 通常、この値はCLSID_NULL。

[in] iid

呼び出し元がキャッシュとの通信に使用するインターフェイスの識別子への参照。 この値は通常IID_IOleCacheです ( IOleCache のインターフェイス識別子と等しくするために OLE ヘッダーで定義されます)。

[out] ppv

riid で要求されたインターフェイス ポインターを受け取るポインター変数のアドレス。 正常に戻ると、*ppvObj には、指定されたキャッシュ オブジェクトへの要求されたインターフェイス ポインターが含まれます。

戻り値

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

リターン コード 説明
E_NOINTERFACE
 riid で表されるインターフェイスは、 オブジェクトではサポートされていません。 パラメーター ppvObj は NULL に設定 されています。
E_OUTOFMEMORY
 操作のメモリ不足。
E_INVALIDARG
1 つ以上のパラメーターが無効です。

解説

CreateDataCache によって作成されるキャッシュ オブジェクトは、キャッシュを制御するための IOleCache、IOleCache2、および IOleCacheControl インターフェイスをサポートします。 また、 IPersistStorage、 IDataObject (アドバイス シンクなし)、 IViewObject、 および IViewObject2 インターフェイスもサポートしています。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objbase.h
Library Ole32.lib
[DLL] Ole32.dll
API セット ext-ms-win-com-ole32-l1-1-5 (Windows 10 バージョン 10.0.15063 で導入)

関連項目

IOleCache

IOleCache2

IOleCacheControl