Função CoLoadLibrary (objbase.h)
Carrega uma DLL específica no processo do chamador.
CoLoadLibrary é equivalente a LoadLibraryEx. CoLoadLibrary não afeta o tempo de vida da biblioteca.
Sintaxe
HINSTANCE CoLoadLibrary(
[in] LPOLESTR lpszLibName,
[in] BOOL bAutoFree
);
Parâmetros
[in] lpszLibName
O nome da biblioteca a ser carregada.
[in] bAutoFree
Esse parâmetro é mantido para compatibilidade com aplicativos de 16 bits, mas é ignorado.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador para a biblioteca carregada; caso contrário, ele é NULL.
Comentários
A função CoGetClassObject não chama CoLoadLibrary. CoLoadLibrary carrega uma DLL especificada pelo parâmetro lpszLibName no processo chamado CoGetClassObject. Os contêineres não devem chamar CoLoadLibrary diretamente.
Internamente, uma contagem de referência é mantida na DLL carregada usando CoLoadLibrary para incrementar a contagem e a função CoFreeLibrary para decrementá-la.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | objbase.h |
| Biblioteca | Ole32.lib |
| DLL | Ole32.dll |
| Conjunto de APIs | ext-ms-win-com-ole32-l1-1-5 (introduzido em Windows 10, versão 10.0.15063) |