Método ITfContextOwnerServices::Serialize (msctf.h)

El método ITfContextOwnerServices::Serialize obtiene una propiedad de un intervalo de texto y escribe los datos de propiedad en un objeto de secuencia. Esto permite a una aplicación almacenar datos de propiedad, por ejemplo, al escribir los datos en un archivo.

Sintaxis

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

Parámetros

[in] pProp

Puntero a una interfaz ITfProperty que identifica la propiedad que se va a serializar.

[in] pRange

Puntero a una interfaz ITfRange que identifica el intervalo del que se obtiene la propiedad.

[out] pHdr

Puntero a una estructura TF_PERSISTENT_PROPERTY_HEADER_ACP que recibe los datos de encabezado de la propiedad .

[in] pStream

Puntero a un objeto IStream en el que el administrador de TSF escribirá los datos de propiedad.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
S_FALSE	La propiedad no se puede serializar.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Los datos de encabezado de propiedad colocados en pHdr son comunes a todas las propiedades y deben conservarse con los datos escritos en pStream. Este mismo par de datos debe pasarse a ITfContextOwnerServices::Unserialize para restaurar los datos de propiedad.

Una aplicación puede guardar todas las propiedades de todo el documento realizando los pasos siguientes.

• Enumera todas las propiedades mediante ITfContext::EnumProperties.
• Dentro de cada propiedad, enumere los intervalos mediante ITfReadOnlyProperty::EnumRanges.
• Pase la propiedad y el intervalo actuales a este método.
• Escriba los datos colocados en pHdr en el archivo.
• Escriba los datos agregados a pStream en el archivo.

Al llamar a este método, la aplicación debe poder conceder un bloqueo de solo lectura sincrónico.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

ITfContextOwnerServices

ITfProperty

ITfRange

TF_PERSISTENT_PROPERTY_HEADER_ACP