Compartir a través de

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

  • Artículo

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