Compartir a través de


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

Obtiene una propiedad de un intervalo de texto y escribe los datos de propiedad en un objeto de secuencia.

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 genéricos para todas las propiedades y deben conservarse con los datos escritos en pStream. Este mismo par de datos debe pasarse a ITextStoreACPServices::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 actual y el intervalo a ITextStoreACPServices::Serialize.
  • 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

Interfaz ITextStoreACPServices, ITextStoreACPServices::Unserialize, ITfContext::EnumProperties, interfaz ITfProperty, interfaz ITfRange, ITfReadOnlyProperty::EnumRanges, TF_PERSISTENT_PROPERTY_HEADER_ACP estructura