GetConvertStg 関数 (coml2api.h)

GetConvertStg 関数は、指定されたストレージ オブジェクトの変換ビットの現在の値を返します。

構文

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

パラメーター

[in] pStg

変換ビットの取得元となるストレージ オブジェクトへの IStorage ポインター。

戻り値

IStorage::OpenStream、 IStorage::OpenStorage、 および ISequentialStream::Read storage and stream access errors。

注釈

GetConvertStg 関数は、ある形式から別の形式へのオブジェクトの変換をサポートするオブジェクト サーバーによって呼び出されます。 サーバーは、以前のクラス識別子 (CLSID) の形式を使用してストレージ オブジェクトを読み取り、オブジェクトの変換をサポートするために新しい CLSID の形式を使用してオブジェクトを書き込める必要があります。 たとえば、あるアプリケーションで作成されたスプレッドシートを、別のアプリケーションで使用される形式に変換できます。

変換ビットは、 SetConvertStg 関数の呼び出しによって設定されます。 コンテナー アプリケーションは、エンド ユーザーの要求に応じてこの関数を呼び出すことができます。または、アプリケーションの新しいバージョンをインストールするときにセットアップ プログラムで呼び出すことができます。 エンド ユーザーは、[変換] ダイアログ ボックスを使用してオブジェクトの 変換を 要求します。 オブジェクトが変換されると、新しい CLSID がオブジェクトに永続的に割り当てられるため、オブジェクトは後で新しい CLSID に関連付けられます。

次に、オブジェクトがアクティブ化されると、そのサーバーは GetConvertStg 関数を呼び出して、ストレージ オブジェクトから変換ビットの値を取得します。 ビットが設定されている場合、オブジェクトの CLSID が変更され、サーバーは古い形式を読み取り、ストレージ オブジェクトの新しい形式を書き込む必要があります。

ビット値を取得した後、オブジェクト アプリケーションは、fConvert パラメーターを FALSE に設定して SetConvertStg 関数を呼び出して、変換ビットをクリアする必要があります。

要件

こちらもご覧ください

SetConvertStg