Função CLSIDFromProgIDEx (objbase.h)

  • Artigo

Dispara a instalação automática se a política COMClassStore estiver habilitada.

Isso é análogo ao comportamento de CoCreateInstance quando nem CLSCTX_ENABLE_CODE_DOWNLOAD nem CLSCTX_NO_CODE_DOWNLOAD são especificados.

Sintaxe

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

Parâmetros

[in] lpszProgID

Um ponteiro para o ProgID cujo CLSID é solicitado.

[out] lpclsid

Recebe um ponteiro para o CLSID recuperado no retorno.

Retornar valor

Essa função pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 O CLSID foi recuperado com êxito.
CO_E_CLASSSTRING
 O CLSID registrado para o ProgID é inválido.
REGDB_E_WRITEREGDB
 Ocorreu um erro ao gravar o CLSID no registro. Consulte os comentários abaixo.

Comentários

CLSCTX_ENABLE_CODE_DOWNLOAD habilita a instalação automática de classes ausentes por meio do IntelliMirror/Application Management do Active Directory. Se esse sinalizador não for especificado, a Política COMClassStore ("Baixar componentes COM ausentes") determinará o comportamento (padrão: sem download).

Se a Política COMClassStore habilitar a instalação automática, CLSCTX_NO_CODE_DOWNLOAD poderá ser usado para permitir explicitamente o download de uma ativação.

Se um dos seguintes valores do Registro estiver habilitado (ou seja, definido como 1), o download automático de classes ausentes será habilitado:

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objbase.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

ProgIDFromCLSID