GetConvertStg, fonction (coml2api.h)
La fonction GetConvertStg retourne la valeur actuelle du bit convert pour l’objet de stockage spécifié.
Syntaxe
HRESULT GetConvertStg(
[in] LPSTORAGE pStg
);
Paramètres
[in] pStg
Pointeur IStorage vers l’objet de stockage à partir duquel le bit de conversion doit être récupéré.
Valeur retournée
Erreurs de stockage IStorage ::OpenStream, IStorage ::OpenStorage et ISequentialStream ::Read storage and stream access.
Remarques
La fonction GetConvertStg est appelée par les serveurs d’objets qui prennent en charge la conversion d’un objet d’un format à un autre. Le serveur doit pouvoir lire l’objet de stockage au format de son identificateur de classe précédent (CLSID) et écrire l’objet au format de son nouveau CLSID pour prendre en charge la conversion de l’objet. Par exemple, une feuille de calcul créée par une application peut être convertie au format utilisé par une autre application.
Le bit convert est défini par un appel à la fonction SetConvertStg . Une application conteneur peut appeler cette fonction à la demande d’un utilisateur final, ou un programme d’installation peut l’appeler lors de l’installation d’une nouvelle version d’une application. Un utilisateur final demande la conversion d’un objet via la boîte de dialogue Convertir vers . Lorsqu’un objet est converti, le nouveau CLSID est affecté de façon permanente à l’objet, de sorte que l’objet est ensuite associé au nouveau CLSID.
Ensuite, lorsque l’objet est activé, son serveur appelle la fonction GetConvertStg pour récupérer la valeur du bit convert de l’objet de stockage. Si le bit est défini, le CLSID de l’objet a été modifié et le serveur doit lire l’ancien format et écrire le nouveau format pour l’objet de stockage.
Après avoir récupéré la valeur de bit, l’application objet doit effacer le bit convert en appelant la fonction SetConvertStg avec son paramètre fConvert défini sur FALSE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | coml2api.h (inclure Ole2.h) |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |