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 |
|---|---|
|
Le CLSID a été récupéré avec succès. |
|
Le CLSID inscrit pour le ProgID n’est pas valide. |
|
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 |