Función SetConvertStg (ole2.h)

La función SetConvertStg establece el bit de conversión en un objeto de almacenamiento para indicar que el objeto se va a convertir en una nueva clase cuando se abre. La configuración se puede recuperar con una llamada a la función GetConvertStg .

Sintaxis

HRESULT SetConvertStg(
  LPSTORAGE pStg,
  BOOL      fConvert
);

Parámetros

pStg

Puntero de IStorage al objeto de almacenamiento en el que se va a establecer el bit de conversión.

fConvert

Si es TRUE, establece el bit de conversión del objeto para indicar que el objeto se va a convertir cuando se abre. Si es FALSE, borra el bit de conversión.

Valor devuelto

Consulte los métodos IStorage::CreateStream, IStorage::OpenStream, ISequentialStream::Read e ISequentialStream::Write para ver posibles errores de acceso a secuencias y almacenamiento.

Comentarios

La función SetConvertStg determina el estado del bit de conversión en un objeto contenido. Lo llama la aplicación contenedora y el servidor en el proceso de convertir un objeto de una clase a otra. Cuando un usuario especifica mediante un cuadro de diálogo Convertir en (que el contenedor genera con una llamada a la función OleUIConvert ) que se va a convertir un objeto, el contenedor debe realizar los pasos siguientes:

1. Descargue el objeto si está cargado actualmente.
2. Llame a WriteClassStg para escribir el nuevo CLSID en el almacenamiento de objetos.
3. Llame a WriteFmtUserTypeStg para escribir el nuevo nombre de tipo de usuario y el formato principal existente en el almacenamiento.
4. Llame a SetConvertStg con el parámetro fConvert establecido en TRUE para indicar que el objeto se ha etiquetado para la conversión a una nueva clase la próxima vez que se cargue.
5. Justo antes de cargar el objeto, llame a OleDoAutoConvert para controlar cualquier conversión de objeto necesaria, a menos que llame a OleLoad, que lo llama internamente.

Cuando se inicializa un objeto desde un objeto de almacenamiento y el servidor es el destino de una operación de conversión a , el servidor de objetos debe hacer lo siguiente:

1. Llame a la función GetConvertStg para recuperar el valor del bit de conversión.
2. Si se establece el bit, el servidor lee los datos del objeto según el formato asociado al nuevo CLSID.
3. Cuando se pide al objeto que se guarde, el objeto debe llamar a la función WriteFmtUserTypeStg con el formato nativo normal y el tipo de usuario del objeto.
4. A continuación, el objeto debe llamar a SetConvertStg con el parámetro fConvert establecido en FALSE para restablecer el bit de conversión del objeto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ole2.h
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

GetConvertStg