CoGetTreatAsClass, fonction (combaseapi.h)

Article
08/22/2023

Retourne le CLSID d’un objet qui peut émuler l’objet spécifié.

Syntaxe

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

Paramètres

[in] clsidOld

CLSID de l’objet qui peut être émulé (traité comme) un objet avec un CLSID différent.

[out] pClsidNew

Pointeur vers l’emplacement où le CLSID qui peut émuler des objets clsidOld est récupéré. Ce paramètre ne peut pas être NULL. S’il n’existe aucune information d’émulation pour les objets clsidOld , le paramètre clsidOld est fourni.

Valeur retournée

Cette fonction peut retourner les valeurs suivantes, ainsi que toutes les valeurs d’erreur retournées par la fonction CLSIDFromString .

Code de retour	Description
S_OK	Un nouveau CLSID a été retourné avec succès.
S_FALSE	Il n’y a pas d’informations d’émulation pour le paramètre clsidOld . Par conséquent, le paramètre pClsidNew est défini sur clsidOld.
REGDB_E_READREGDB	Une erreur s’est produite lors de la lecture du Registre.

Remarques

CoGetTreatAsClass retourne l’entrée TreatAs dans le Registre pour l’objet spécifié. L’entrée TreatAs , si elle est définie, est le CLSID d’un objet inscrit (une application) qui peut émuler l’objet en question. L’entrée TreatAs est définie via un appel à la fonction CoTreatAsClass . L’émulation permet à une application d’ouvrir et de modifier un objet d’un autre format, tout en conservant le format d’origine de l’objet. Les objets du CLSID d’origine sont activés et traités comme des objets du deuxième CLSID. Lorsque l’objet est enregistré, cela peut entraîner la perte des modifications non prises en charge par le format d’origine. S’il n’existe aucune entrée TreatAs pour l’objet spécifié, cette fonction retourne le CLSID de l’objet d’origine (clsidOld).

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	combaseapi.h (inclure Objbase.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

CoTreatAsClass

Partager via