Metodo ITfContextOwnerServices::Serialize (msctf.h)

Articolo
08/24/2023

Il metodo ITfContextOwnerServices::Serialize ottiene una proprietà da un intervallo di testo e scrive i dati delle proprietà in un oggetto stream. Ciò consente a un'applicazione di archiviare i dati delle proprietà, ad esempio quando si scrivono i dati in un file.

Sintassi

HRESULT Serialize(
  [in]  ITfProperty                       *pProp,
  [in]  ITfRange                          *pRange,
  [out] TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in]  IStream                           *pStream
);

Parametri

[in] pProp

Puntatore a un'interfaccia ITfProperty che identifica la proprietà da serializzare.

[in] pRange

Puntatore a un'interfaccia ITfRange che identifica l'intervallo ottenuto dalla proprietà.

[out] pHdr

Puntatore a una struttura TF_PERSISTENT_PROPERTY_HEADER_ACP che riceve i dati di intestazione per la proprietà.

[in] pStream

Puntatore a un oggetto IStream in cui il gestore TSF scriverà i dati delle proprietà.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Impossibile serializzare la proprietà.
E_FAIL	Si è verificato un errore non specificato.

Commenti

I dati dell'intestazione delle proprietà inseriti in pHdr sono comuni a tutte le proprietà e devono essere conservati con i dati scritti in pStream. Questa stessa coppia di dati deve essere passata a ITfContextOwnerServices::Unserialize per ripristinare i dati della proprietà.

Un'applicazione può salvare tutte le proprietà per l'intero documento eseguendo la procedura seguente.

Enumerare tutte le proprietà usando ITfContext::EnumProperties.
All'interno di ogni proprietà enumerare gli intervalli usando ITfReadOnlyProperty::EnumRanges.
Passare la proprietà corrente e l'intervallo a questo metodo.
Scrivere i dati inseriti in pHdr nel file.
Scrivere i dati aggiunti a pStream nel file.

Quando si chiama questo metodo, l'applicazione deve essere in grado di concedere un blocco di sola lettura sincrono.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfContextOwnerServices

ITfProperty

ITfRange

TF_PERSISTENT_PROPERTY_HEADER_ACP

Condividi tramite