ProgIDFromCLSID
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função recupera o ProgID para um determinado CLSID.
Syntax
WINOLEAPI ProgIDFromCLSID(
REFCLSID clsid,
LPOLESTR* lplpszProgID
);
Parameters
- CLSID
[no] Especifica o CLSID para os quais o ProgID é solicitada.
- lplpszProgID
[out] Endereço do LPOLESTR ponteiro variável que recebe um ponteiro para o ProgID seqüência de caracteres.
Return Value
- S_OK
O ProgID retornou com êxito.
- REGDB_E_CLASSNOTREG
Classe não registrada no Registro.
- REGDB_E_READREGDB
Erro de leitura Registro.
Remarks
Cada classe de objeto OLE listados na caixa de diálogo Insert Object deve ter um programático identificador (ProgID), um seqüência de caracteres que identificam exclusivamente uma classe determinado, armazenado no Registro.
Bem como determinar a qualificação para o caixa de diálogo Insert Object, o ProgID pode ser usado como um identificador em uma linguagem macro programação para identificar uma classe. Finalmente, o ProgID é também o nome classe usado para um objeto de uma classe OLE que é colocado em um contêiner OLE 1.
O ProgIDFromCLSID função usa as entradas no Registro para fazer a conversão. Os autores aplicativo OLE são responsáveis por garantir que o Registro está configurado corretamente no programa de instalação do aplicativo.
O ProgID seqüência de caracteres devem ser diferente do nome de qualquer aplicativo OLE 1, incluindo a versão OLE 1 do mesmo aplicativo, se houver uma classe.
Além disso, um ProgID seqüência de caracteres não devem conter mais de 39 caracteres, iniciar com um dígito ou, Except for um único período, contenham qualquer pontuação (incluindo sublinhados).
O ProgID nunca deve ser mostrado para o usuário na interface de usuário. Se você precisar um seqüência de caracteres exibível curto para um objeto, chamar IOleObject::GetUserType.
Chamar o CLSIDFromProgID função para localizar o CLSID associado com um determinado ProgID. CLSIDs podem ser liberados com o alocador tarefa (referir para o CoGetMalloc função).
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |