ITextStoreACPServices ::Unserialize, méthode (msctf.h)

Article
03/04/2024

Prend des données de propriété sérialisées précédemment et les applique à un objet de propriété.

Syntaxe

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

Paramètres

[in] pProp

Pointeur vers un objet ITfProperty qui reçoit les données de propriété.

[in] pHdr

Pointeur vers une structure TF_PERSISTENT_PROPERTY_HEADER_ACP qui contient les données d’en-tête de la propriété .

[in] pStream

Pointeur vers un objet IStream qui contient les données de propriété. Ce paramètre peut être NULL si pLoader n’est pas NULL. Ce paramètre est ignoré si pLoader n’a pas la valeur NULL.

[in] pLoader

Pointeur vers un objet ITfPersistentPropertyLoaderACP que le gestionnaire TSF utilisera pour obtenir les données de propriété. Ce paramètre peut être NULL si pStream n’est pas NULL.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
TF_S_ASYNC	Les données de propriété sont obtenues de manière asynchrone.
TF_E_SYNCHRONOUS	Impossible d’obtenir un verrou synchrone en lecture seule.
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Si pStream est spécifié au lieu de pLoader, les données de propriété sont lues à partir de pStream lors de l’appel à Unserialize . Si pLoader est spécifié au lieu de pStream, les données de propriété sont lues de manière asynchrone à partir de pLoader . L’utilisation de pStream peut entraîner de longs retards si les données de propriété sont volumineuses.

Lors de l’appel de cette méthode, l’application doit être en mesure d’accorder un verrou synchrone en lecture seule.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

Interface ITextStoreACPServices, ITextStoreACPServices ::Serialize, ITfContext ::EnumProperties, interface ITfProperty, interface ITfRange, ITfReadOnlyProperty ::EnumRanges, TF_PERSISTENT_PROPERTY_HEADER_ACP structure

Partager via