ITfContextOwnerServices::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 を指定した場合、このメソッドの呼び出し中に 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

関連項目

ITfContextOwnerServices インターフェイス、 ITfContextOwnerServices::Serialize、 ITfProperty インターフェイス、 ITfPersistentPropertyLoaderACP インターフェイス、 TF_PERSISTENT_PROPERTY_HEADER_ACP構造体