ITextStoreACPServices::Unserialize メソッド (msctf.h)

  • [アーティクル]

以前にシリアル化されたプロパティ データを取得し、プロパティ オブジェクトに適用します。

構文

HRESULT Unserialize(
  [in] ITfProperty                             *pProp,
  [in] const TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in] IStream                                 *pStream,
  [in] ITfPersistentPropertyLoaderACP          *pLoader
);

パラメーター

[in] pProp

プロパティ データを受け取る ITfProperty オブジェクトへのポインター。

[in] pHdr

プロパティのヘッダー データを含む TF_PERSISTENT_PROPERTY_HEADER_ACP 構造体へのポインター。

[in] pStream

プロパティ データを含む IStream オブジェクトへのポインター。 pLoader が NULL でない場合、このパラメーターは NULL にすることができます。 pLoader が NULL でない場合、このパラメーターは無視されます。

[in] pLoader

TSF マネージャーがプロパティ データの取得に使用する ITfPersistentPropertyLoaderACP オブジェクトへのポインター。 pStream が NULL でない場合、このパラメーターは NULL にすることができます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
TF_S_ASYNC
 プロパティ データは非同期的に取得されます。
TF_E_SYNCHRONOUS
 同期読み取り専用ロックを取得できません。
E_FAIL
 未指定のエラーが発生しました。

解説

pLoader ではなく pStream を指定した場合、プロパティ データは Unserialize の呼び出し中に pStream から読み取られます。 pStream ではなく pLoader が指定されている場合、プロパティ データは pLoader から非同期的に読み取られます。 pStream を使用すると、プロパティ データが大きい場合に長い遅延が発生する可能性があります。

このメソッドの呼び出し中に、アプリケーションは同期読み取り専用ロックを許可できる必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional の TSF 1.0

こちらもご覧ください

ITextStoreACPServices インターフェイス、 ITextStoreACPServices::Serialize、 ITfContext::EnumProperties、 ITfProperty インターフェイス、 ITfRange インターフェイス、 ITfReadOnlyProperty::EnumRanges、 TF_PERSISTENT_PROPERTY_HEADER_ACP 構造体