Funzione CLSIDFromProgIDEx (combaseapi.h)

Attiva l'installazione automatica se il criterio COMClassStore è abilitato.

Si tratta di un comportamento analogo al comportamento di CoCreateInstance quando non vengono specificati né CLSCTX_ENABLE_CODE_DOWNLOAD né CLSCTX_NO_CODE_DOWNLOAD.

Sintassi

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

Parametri

[in] lpszProgID

Puntatore al ProgID il cui CLSID viene richiesto.

[out] lpclsid

Riceve un puntatore al CLSID recuperato in caso di restituzione.

Valore restituito

Questa funzione può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
ClSID è stato recuperato correttamente.
CO_E_CLASSSTRING
Il CLSID registrato per ProgID non è valido.
REGDB_E_WRITEREGDB
Si è verificato un errore durante la scrittura del CLSID nel Registro di sistema. Vedere Le osservazioni riportate di seguito.

Commenti

CLSCTX_ENABLE_CODE_DOWNLOAD abilita l'installazione automatica delle classi mancanti tramite IntelliMirror/Gestione applicazioni da Active Directory. Se questo flag non è specificato, il criterio COMClassStore ("Scarica componenti COM mancanti") determina il comportamento (impostazione predefinita: nessun download).

Se il criterio COMClassStore abilita l'installazione automatica, è possibile usare CLSCTX_NO_CODE_DOWNLOAD per consentire esplicitamente il download per un'attivazione.

Se uno dei valori del Registro di sistema seguenti è abilitato (ovvero impostato su 1), il download automatico delle classi mancanti è abilitato:

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

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione combaseapi.h (include Objbase.h)
Libreria Ole32.lib
DLL Ole32.dll

Vedi anche

ProgIDFromCLSID