Função LoadTypeLibWithResolver

Artigo
05/10/2023

Carrega uma biblioteca de tipos e utiliza a interface ITypeLibResolver fornecida para resolver quaisquer bibliotecas de tipos referenciadas internamente.

Sintaxe

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

Parâmetros

szFile
[in] O caminho do ficheiro da biblioteca de tipos.

regkind
[in] Um sinalizador de enumeração REGKIND que controla a forma como a biblioteca de tipos é registada. Os valores possíveis são:

REGKIND_DEFAULT: utilize o comportamento de registo predefinido.
REGKIND_REGISTER: registe esta biblioteca de tipos.
REGKIND_NONE: não registe esta biblioteca de tipos.

pTlbResolver
[in] Um ponteiro para a implementação da interface ITypeLibResolver.

pptlib
[fora] Uma referência à biblioteca de tipos que está a ser carregada.

Devolver Valor

Um dos valores HRESULT listados na tabela seguinte.

Valor devolvido	Significado
`S_OK`	Com êxito.
`E_OUTOFMEMORY`	Sem memória.
`E_POINTER`	Um ou mais dos ponteiros são inválidos.
`E_INVALIDARG`	Um ou mais dos argumentos são inválidos.
`TYPE_E_IOERROR`	A função não conseguiu escrever no ficheiro.
`TYPE_E_REGISTRYACCESS`	Não foi possível abrir a base de dados de registo do sistema.
`TYPE_E_INVALIDSTATE`	Não foi possível abrir a biblioteca de tipos.
`TYPE_E_CANTLOADLIBRARY`	Não foi possível carregar a biblioteca de tipos ou dLL.

Observações

O Tlbexp.exe (Exportador de Bibliotecas de Tipos) chama a LoadTypeLibWithResolver função durante o processo de conversão assemblagem-a-tipo-biblioteca.

Esta função carrega a biblioteca de tipos especificada com acesso mínimo ao registo. Em seguida, a função examina a biblioteca de tipos para bibliotecas de tipos referenciadas internamente, cada uma das quais tem de ser carregada e adicionada à biblioteca de tipos principal.

Antes de uma biblioteca de tipos referenciado poder ser carregada, o respetivo caminho de ficheiro de referência tem de ser resolvido para um caminho de ficheiro completo. Isto é feito através do método ResolveTypeLib fornecido pela interface ITypeLibResolver, que é transmitida no pTlbResolver parâmetro.

Quando o caminho de ficheiro completo da biblioteca de tipos referenciado é conhecido, a LoadTypeLibWithResolver função carrega e adiciona a biblioteca de tipos referenciados à biblioteca de tipos principais, criando uma biblioteca de tipo primário combinada.

Depois de a função resolver e carregar todas as bibliotecas de tipos referenciadas internamente, devolve uma referência à biblioteca de tipos resolvidos principal no pptlib parâmetro.

Geralmente LoadTypeLibWithResolver , a função é denominada pelo Tlbexp.exe (Exportador de Bibliotecas de Tipos), que fornece a sua própria implementação interna da interface ITypeLibResolver no pTlbResolver parâmetro.

Se ligar LoadTypeLibWithResolver diretamente, tem de fornecer a sua própria implementação da interface ITypeLibResolver .

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: TlbRef.h

Biblioteca: TlbRef.lib

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

Partilhar via