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 関数を呼び出して、変換ビットをクリアする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | coml2api.h (Ole2.h を含む) |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |