OleGetAutoConvert, fonction (ole2.h)

Détermine si le Registre est défini pour que les objets d’un CLSID spécifié soient convertis automatiquement en un autre CLSID et, le cas échéant, récupère le nouveau CLSID.

Syntaxe

HRESULT OleGetAutoConvert(
  [in]  REFCLSID clsidOld,
  [out] LPCLSID  pClsidNew
);

Paramètres

[in] clsidOld

CLSID de l’objet.

[out] pClsidNew

Pointeur vers une variable pour recevoir le nouveau CLSID, le cas échéant. Si la conversion automatique pour clsidOld n’est pas définie dans le Registre, clsidOld est retourné. Le paramètre pClsidNew n’a jamais la valeur NULL.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	Une valeur a été retournée via le paramètre pclsidNew .
REGDB_E_CLASSNOTREG	Le CLSID n’est pas correctement inscrit dans le Registre.
REGDB_E_READREGDB	Erreur de lecture à partir du Registre.
REGDB_E_KEYMISSING	La conversion automatique n’est pas active ou il n’y a pas d’entrée de Registre pour le paramètre clsidOld .

Remarques

OleGetAutoConvert retourne l’entrée AutoConvertTo dans le Registre pour l’objet spécifié. La sous-clé AutoConvertTo spécifie si les objets d’un CLSID donné doivent être convertis automatiquement en nouveau CLSID. Il est généralement utilisé pour convertir les fichiers créés par des versions antérieures d’une application vers la version actuelle. S’il n’existe aucune entrée AutoConvertTo , cette fonction retourne la valeur clsidOld.

La fonction OleDoAutoConvert appelle OleGetAutoConvert pour déterminer si l’objet spécifié doit être converti. Une application conteneur qui prend en charge la conversion d’objets doit appeler OleDoAutoConvert chaque fois qu’elle charge un objet. Si le conteneur utilise la fonction d’assistance OleLoad , il n’a pas besoin d’appeler OleDoAutoConvert explicitement, car OleLoad l’appelle en interne.

Pour configurer la conversion automatique d’une classe donnée, vous pouvez appeler la fonction OleSetAutoConvert (généralement dans le programme d’installation d’une installation d’une application). Cette fonction utilise la sous-clé AutoConvertTo pour baliser une classe d’objets en vue d’une conversion automatique en une autre classe d’objets. Il s’agit d’une sous-clé de la clé CLSID.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-0 (introduit dans Windows 8)

Voir aussi

AutoConvertTo

OleDoAutoConvert

OleSetAutoConvert