Condividi tramite


Metodo ITfContextOwnerServices::Serialize (msctf.h)

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