Compartilhar via

Função ProgIDFromCLSID (combaseapi.h)

  • Artigo

Recupera o ProgID para um determinado CLSID.

Sintaxe

HRESULT ProgIDFromCLSID(
  [in]  REFCLSID clsid,
  [out] LPOLESTR *lplpszProgID
);

Parâmetros

[in] clsid

O CLSID para o qual o ProgID deve ser solicitado.

[out] lplpszProgID

O endereço de uma variável de ponteiro que recebe a cadeia de caracteres ProgID. A cadeia de caracteres que representa clsid inclui chaves delimiação.

Retornar valor

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

Código de retorno Descrição
S_OK
 O ProgID foi retornado com êxito.
REGDB_E_CLASSNOTREG
 Classe não registrada no registro.
REGDB_E_READREGDB
 Ocorreu um erro ao ler do registro.

Comentários

Cada classe de objeto OLE listada na caixa de diálogo Inserir Objeto deve ter um ProgID (identificador programático), uma cadeia de caracteres que identifica exclusivamente uma determinada classe, armazenada no registro. Além de determinar a qualificação para a caixa de diálogo Inserir Objeto , o ProgID pode ser usado como um identificador em uma linguagem de programação de macro para identificar uma classe. Por fim, ProgID também é o nome de classe usado para um objeto de uma classe OLE que é colocada em um contêiner OLE 1.

ProgIDFromCLSID usa entradas no registro para fazer a conversão. Os autores de aplicativos OLE são responsáveis por garantir que o registro esteja configurado corretamente no programa de instalação do aplicativo.

A cadeia de caracteres ProgID deve ser diferente do nome de classe de qualquer aplicativo OLE 1, incluindo a versão OLE 1 do mesmo aplicativo, se houver um. Além disso, uma cadeia de caracteres ProgID não deve conter mais de 39 caracteres, começar com um dígito ou, exceto por um único período, conter qualquer pontuação (incluindo sublinhados).

O ProgID nunca deve ser mostrado ao usuário na interface do usuário. Se você precisar de uma cadeia de caracteres curta e exibivel para um objeto, chame IOleObject::GetUserType.

Chame a função CLSIDFromProgID para localizar o CLSID associado a um determinado ProgID. Certifique-se de liberar o ProgID retornado quando terminar de fazer isso chamando a função CoTaskMemFree .

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

CLSIDFromProgID