Función GetConvertStg (coml2api.h)
La función GetConvertStg devuelve el valor actual del bit de conversión para el objeto de almacenamiento especificado.
Sintaxis
HRESULT GetConvertStg(
[in] LPSTORAGE pStg
);
Parámetros
[in] pStg
Puntero de IStorage al objeto de almacenamiento desde el que se va a recuperar el bit de conversión.
Valor devuelto
IStorage::OpenStream, IStorage::OpenStorage e ISequentialStream::Read y errores de acceso a secuencias.
Comentarios
Los servidores de objetos llaman a la función GetConvertStg que admiten la conversión de un objeto de un formato a otro. El servidor debe poder leer el objeto de almacenamiento con el formato de su identificador de clase anterior (CLSID) y escribir el objeto con el formato de su nuevo CLSID para admitir la conversión del objeto. Por ejemplo, una hoja de cálculo creada por una aplicación se puede convertir al formato usado por otra aplicación.
El bit de conversión se establece mediante una llamada a la función SetConvertStg . Una aplicación contenedora puede llamar a esta función en la solicitud de un usuario final o un programa de instalación puede llamarla al instalar una nueva versión de una aplicación. Un usuario final solicita la conversión de un objeto a través del cuadro de diálogo Convertir en . Cuando se convierte un objeto, el nuevo CLSID se asigna permanentemente al objeto, por lo que el objeto se asocia posteriormente al nuevo CLSID.
A continuación, cuando se activa el objeto, su servidor llama a la función GetConvertStg para recuperar el valor del bit de conversión del objeto de almacenamiento. Si se establece el bit, se ha cambiado el CLSID del objeto y el servidor debe leer el formato antiguo y escribir el nuevo formato para el objeto de almacenamiento.
Después de recuperar el valor de bit, la aplicación de objeto debe borrar el bit de conversión llamando a la función SetConvertStg con su parámetro fConvert establecido en FALSE.
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 | coml2api.h (include Ole2.h) |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |