CLSIDFromProgID, fonction (combaseapi.h)

  • Article

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