Função CLSIDFromProgID (combaseapi.h)

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