Função ProgIDFromCLSID (combaseapi.h)

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.

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

Confira também

CLSIDFromProgID