LoadTypeLib
.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 carrega e registra um typelib2 biblioteca tipo.
Syntax
HRESULT LoadTypeLib(
OLECHAR FAR* szFile,
ITypeLib FAR* FAR* pptlib
);
Parameters
- szFile
[no] Seqüência de caracteres NULL-Terminated que contém o nome do arquivo a partir do qual LoadTypeLib deve tentar carregar uma biblioteca tipo.
- pptlib
[out] Em retorno, um ponteiro para um ponteiro para a biblioteca tipo carregado.
Return Value
Retorna os valores HRESULT mostrados a seguinte tabela.
| Valor | Descrição |
|---|---|
S_OK |
O sucesso. |
E_OUTOFMEMORY |
Memória insuficiente. |
E_INVALIDARG |
Um ou mais argumentos é inválido. |
TYPE_E_IOERROR |
A função não pôde gravar o arquivo. |
TYPE_E_INVALIDSTATE |
Não foi possível abrir a biblioteca tipo. |
TYPE_E_INVDATAREAD |
A função não pôde ler a partir de arquivo. |
TYPE_E_UNSUPFORMAT |
A biblioteca tipo tem um formato mais antigo. |
TYPE_E_UNKNOWNLCID |
O LCID não encontrado no OLE-com suporte DLLs. |
TYPE_E_CANTLOADLIBRARY |
A biblioteca tipo ou DLL não pôde ser carregado. |
Outros códigos de retorno |
Todos os Erros FACILITY_STORAGE podem ser retornados. |
Remarks
Windows Embedded CE e Windows Mobile suporte somente typelib2 Bibliotecas tipo. O LoadTypeLib função carrega bibliotecas tipo somente de um recurso; Isto é, de DLL ou EXE arquivos. Ele não irá carregar externa ou autônomo arquivos biblioteca de tipos.
A função LoadTypeLib Carrega uma biblioteca tipo (geralmente criada com MkTypLib) armazenada no arquivo especificado.
Se szFile Especifica um nome arquivo com nenhum caminho, LoadTypeLib Procura o arquivo e continua da seguinte maneira:
Se o arquivo for um autônomo biblioteca tipo implementada por TypeLib.dll, a biblioteca é carregada diretamente.
Se o arquivo for um DLL ou um arquivo executável, ele será carregado.
Por padrão, a biblioteca tipo é extraído do primeiro recurso de tipo ITypeLib.
Para carregar um tipo diferente de recurso biblioteca, anexar um índice de números inteiros para szFile, as in o seguinte exemplo:LoadTypeLib(C:\MONTANA\EXE\MFA.EXE\3, pptlib)Esta declaração carrega o recurso biblioteca tipo 3 do arquivo Mfa.exe.
Se o arquivo for nenhuma das opções acima, o nome de arquivo é analisado em uma moniker (um objeto que representa uma origem link File-Based) e é então ligado para o moniker.
Essa abordagem permite LoadTypeLib a ser usado em bibliotecas tipo externo, incluindo em-memória tipo bibliotecas. Bibliotecas tipo externa não podem residir em um DLL ou um arquivo executável.
Para obter mais informações sobre identificadores de origem, consulte o Referência do programador do OLE Na Microsoft® Win32® SDK.
Se a biblioteca tipo já está carregada, LoadTypeLib Incrementa contagem de referência do biblioteca de tipos e recupera um ponteiro para a biblioteca tipo.
Para compatibilidade com versões anteriores, LoadTypeLib Registra a biblioteca tipo se o caminho não for especificado na szFile parâmetro. LoadTypeLib Será não registrar a biblioteca tipo se o caminho da biblioteca de tipo for especificado. É recomendável que RegisterTypeLib ser usado para registrar um biblioteca de tipos.
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
Requirements
| Header | oleauto.h |
| Library | oleaut32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |