ITfContextOwnerServices::Unserialize-Methode (msctf.h)

Artikel
08/24/2023

Wendet zuvor serialisierte Eigenschaftendaten auf ein Eigenschaftsobjekt an.

Syntax

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

Parameter

[in] pProp

Zeiger auf ein ITfProperty-Objekt , das die Eigenschaftendaten empfängt.

[in] pHdr

Zeiger auf eine TF_PERSISTENT_PROPERTY_HEADER_ACP-Struktur , die die Headerdaten für die Eigenschaft enthält.

[in] pStream

Zeiger auf ein IStream-Objekt , das die Eigenschaftendaten enthält. Dieser Parameter kann NULL sein, wenn pLoader nicht NULL ist. Dieser Parameter wird ignoriert, wenn pLoader nicht NULL ist.

[in] pLoader

Zeiger auf ein ITfPersistentPropertyLoaderACP-Objekt , das der TSF-Manager zum Abrufen der Eigenschaftsdaten verwendet. Dieser Parameter kann NULL sein, wenn pStream nicht NULL ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TF_S_ASYNC	Die Eigenschaftendaten werden asynchron abgerufen.
TF_E_SYNCHRONOUS	Eine synchrone schreibgeschützte Sperre kann nicht abgerufen werden.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Wenn pStream anstelle von pLoader angegeben wird, werden die Eigenschaftsdaten während des Aufrufs dieser Methode aus pStream gelesen. Wenn pLoader anstelle von pStream angegeben wird, werden die Eigenschaftsdaten asynchron aus pLoader gelesen. Die Verwendung von pStream kann zu langen Verzögerungen führen, wenn die Eigenschaftendaten groß sind.

Beim Aufrufen dieser Methode muss die Anwendung in der Lage sein, eine synchrone schreibgeschützte Sperre zu gewähren.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfContextOwnerServices-Schnittstelle, ITfContextOwnerServices::Serialize, ITfProperty-Schnittstelle, ITfPersistentPropertyLoaderACP-Schnittstelle, TF_PERSISTENT_PROPERTY_HEADER_ACP-Struktur

Freigeben über