CoLoadLibrary

9/8/2008

Essa função é chamado internamente pela CoGetClassObject, quando o contexto classe indica um DLL, para carregar um DLL específico para processo do chamador. Aplicativos não devem chamá-la diretamente.

Syntax

HINSTANCE CoLoadLibrary(
  LPOLESTR lpszLibName, 
  BOOL bAutoFree
); 

Parameters

• lpszLibName
  [no] Ponteiro longo para o seqüência de caracteres NULL-Terminated que contém o nome da biblioteca a ser carregado. O uso desse nome é o mesmo as in a função Win32 LoadLibrary.

• bAutoFree
  [no] Ignorado. Descarregar explicitamente com a CoFreeLibrary função.

Return Value

O identificador da biblioteca carregada indica sucesso. NULL Indica que a biblioteca não pôde ser carregada.

Remarks

O CoLoadLibrary função é chamado internamente pela CoGetClassObject função quando o classe contexto (CLSCTX) indica um DLL. CoLoadLibrary Carrega um DLL especificado pelo lpszLibName parâmetro para o processo que chamado CoGetClassObject. Recipientes não devem chamar CoLoadLibrary diretamente.

Internamente, um contagem de referência é mantido na DLL carregado, usando CoLoadLibrary Para incremento a contagem e o CoFreeLibrary diminuição functionto-la.

Passando para esta função qualquer inválido e, em algumas circunstâncias, NULL ponteiros resultam em terminação inesperada do aplicativo.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CoFreeLibrary
CoGetClassObject

Other Resources

LoadLibrary