Metodo ITextStoreACPServices::Serialize (msctf.h)

Ottiene una proprietà da un intervallo di testo e scrive i dati delle proprietà in un oggetto stream.

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 generici per tutte le proprietà e devono essere conservati con i dati scritti in pStream. Questa stessa coppia di dati deve essere passata a ITextStoreACPServices::Unserialize per ripristinare i dati delle 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 ITextStoreACPServices::Serialize.
• 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

Interfaccia ITextStoreACPServices, ITextStoreACPServices::Unserialize, ITfContext::EnumProperties, interfaccia ITfProperty, interfaccia ITfReadOnlyProperty::EnumRanges, struttura TF_PERSISTENT_PROPERTY_HEADER_ACP