CLSIDFromProgIDEx, fonction (combaseapi.h)

Déclenche l’installation automatique si la stratégie COMClassStore est activée.

Cela est analogue au comportement de CoCreateInstance lorsque ni CLSCTX_ENABLE_CODE_DOWNLOAD ni CLSCTX_NO_CODE_DOWNLOAD ne sont spécifiés.

Syntaxe

HRESULT CLSIDFromProgIDEx(
  [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

CLSCTX_ENABLE_CODE_DOWNLOAD permet l’installation automatique des classes manquantes via IntelliMirror/Gestion des applications à partir d’Active Directory. Si cet indicateur n’est pas spécifié, la stratégie COMClassStore (« Télécharger les composants COM manquants ») détermine le comportement (par défaut : aucun téléchargement).

Si la stratégie COMClassStore permet l’installation automatique, CLSCTX_NO_CODE_DOWNLOAD peut être utilisé pour interdire explicitement le téléchargement pour une activation.

Si l’une des valeurs de Registre suivantes est activée (c’est-à-dire définie sur 1), le téléchargement automatique des classes manquantes est activé :

• HKEY_CURRENT_USER\Software\Policies\Microsoft\Windows\App Management\COMClassStore
• HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\App Management \COMClassStore

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

ProgIDFromCLSID