Função CLSIDFromProgID (combaseapi.h)

  • Artigo

Pesquisa um CLSID no registro, considerando um ProgID.

Sintaxe

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

Dado um ProgID, CLSIDFromProgID pesquisa seu CLSID associado no registro. Se o ProgID não puder ser encontrado no registro, CLSIDFromProgID criará um CLSID OLE 1 para o ProgID e uma entrada CLSID no registro. Devido às restrições impostas aos valores CLSID do OLE 1, CLSIDFromProgID e CLSIDFromString são as duas únicas funções que podem ser usadas para gerar um CLSID para um objeto OLE 1.

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 combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

CLSIDFromProgIDEx

ProgIDFromCLSID