Função de LoadTypeLibWithResolver

Artigo
08/08/2011

Carrega uma biblioteca de tipos e usa o fornecido interface de ITypeLibResolver para resolver quaisquer bibliotecas de tipos referenciada internamente.

HRESULT LoadTypeLibWithResolver(
    [in]  LPCOLESTR           szFile,
    [in]  REGKIND             regkind,
    [in]  ITypeLibResolver   *pTlbResolver,
    [out] ITypeLib          **pptlib);

Parâmetros

szFile
[in] O caminho do arquivo de biblioteca de tipos.
regkind
[in] A REGKIND o sinalizador de enumeração que controla como a biblioteca de tipos é registrada. Seus valores possíveis são:
- REGKIND_DEFAULT: Use o comportamento de registro padrão.
- REGKIND_REGISTER: Registre a biblioteca de tipos.
- REGKIND_NONE: Não registre a biblioteca de tipos.
pTlbResolver
[in] Um ponteiro para a implementação de interface de ITypeLibResolver.
pptlib
[out] Uma referência à biblioteca de tipos que está sendo carregada.

Valor de retorno

Um dos valores HRESULT listados na tabela a seguir.

Valor de Retorno	Significado
S_OK	Sucesso.
E_OUTOFMEMORY	Out of memory.
E_POINTER	Um ou mais dos ponteiros são inválidos.
E_INVALIDARG	Um ou mais argumentos são inválidos.
TYPE_E_IOERROR	A função não pôde gravar no arquivo.
TYPE_E_REGISTRYACCESS	Não foi possível abrir o banco de dados de registro do sistema.
TYPE_E_INVALIDSTATE	A biblioteca de tipos não pôde ser aberta.
TYPE_E_CANTLOADLIBRARY	A biblioteca de tipo ou a DLL não pôde ser carregado.

Comentários

O Tlbexp. exe (exportador da biblioteca) chamadas de LoadTypeLibWithResolver função durante o processo de conversão de assembly para tipo de biblioteca.

Esta função carrega a biblioteca de tipo especificado com acesso mínimo no registro. A função, em seguida, examina a biblioteca de tipos para bibliotecas de tipos referenciada internamente, cada um deles deve ser carregada e adicionada à biblioteca de tipo pai.

Antes de uma biblioteca de tipos referenciada pode ser carregada, o seu caminho de arquivo de referência deve ser resolvido para um caminho de arquivo completo. Isso é realizado através do ResolveTypeLib método fornecido pelo ITypeLibResolver interface, que é passado a pTlbResolver parâmetro.

Quando o caminho completo do arquivo de biblioteca de tipos referenciada é conhecido, o LoadTypeLibWithResolver função carrega e adiciona a biblioteca de tipos referenciada na biblioteca de tipo pai, criando uma biblioteca de tipo de mestre combinado.

Depois que a função resolve e carrega todas as bibliotecas de tipos referenciada internamente, ele retorna uma referência à biblioteca de tipo de resolvido mestre na pptlib parâmetro.

O LoadTypeLibWithResolver função geralmente é chamada pelo Tlbexp. exe (exportador da biblioteca), que fornece seu próprio interno ITypeLibResolver interface implementação a pTlbResolver parâmetro.

Se você chamar LoadTypeLibWithResolver diretamente, você deve fornecer seu próprio interface de ITypeLibResolver implementação.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: TlbRef.h

Biblioteca: TlbRef.lib

.NET Framework versão: 3.5, 3.0, 2.0

Consulte também

Referência

LoadTypeLibEx

Outros recursos

Funções do auxiliar de Tlbexp (referência de API não gerenciada)

Compartilhar via