CLSIDFromProgID, fonction (combaseapi.h)

Article
02/24/2024

Recherche un CLSID dans le Registre, en fonction d’un ProgID.

Syntaxe

HRESULT CLSIDFromProgID(
  [in]  LPCOLESTR lpszProgID,
  [out] LPCLSID   lpclsid
);

Paramètres

[in] lpszProgID

Pointeur vers le ProgID dont le CLSID est demandé.

[out] lpclsid

Reçoit un pointeur vers le CLSID récupéré au retour.

Valeur retournée

Cette fonction peut retourner les valeurs suivantes.

Code de retour	Description
S_OK	Le CLSID a été récupéré avec succès.
CO_E_CLASSSTRING	Le CLSID inscrit pour le ProgID n’est pas valide.
REGDB_E_WRITEREGDB	Une erreur s’est produite lors de l’écriture du CLSID dans le Registre. Voir remarques ci-dessous.

Remarques

Avec un ProgID, CLSIDFromProgID recherche son CLSID associé dans le Registre. Si le ProgID est introuvable dans le Registre, CLSIDFromProgID crée un CLSID OLE 1 pour le ProgID et une entrée CLSID dans le Registre. En raison des restrictions imposées aux valeurs CLSID OLE 1, CLSIDFromProgID et CLSIDFromString sont les deux seules fonctions qui peuvent être utilisées pour générer un CLSID pour un objet OLE 1.

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

CLSIDFromProgIDEx

ProgIDFromCLSID

Partager via