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