Função CoLoadLibrary (objbase.h)

  • Artigo

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)

Confira também

CoFreeAllLibraries

CoFreeLibrary

Cofreeunusedlibraries

CoFreeUnusedLibrariesEx