Funzione CoLoadLibrary (objbase.h)

Carica una DLL specifica nel processo del chiamante.

CoLoadLibrary equivale a LoadLibraryEx. CoLoadLibrary non influisce sulla durata della libreria.

Sintassi

HINSTANCE CoLoadLibrary(
  [in] LPOLESTR lpszLibName,
  [in] BOOL     bAutoFree
);

Parametri

[in] lpszLibName

Nome della libreria da caricare.

[in] bAutoFree

Questo parametro viene mantenuto per la compatibilità con applicazioni a 16 bit, ma viene ignorato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per la libreria caricata; in caso contrario, è NULL.

Commenti

La funzione CoGetClassObject non chiama CoLoadLibrary. CoLoadLibrary carica una DLL specificata dal parametro lpszLibName nel processo denominato CoGetClassObject. I contenitori non devono chiamare direttamente CoLoadLibrary .

Internamente, un conteggio dei riferimenti viene mantenuto nella DLL caricata usando CoLoadLibrary per incrementare il conteggio e la funzione CoFreeLibrary per decrementarla.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objbase.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-5 (introdotta in Windows 10 versione 10.0.15063)

Vedi anche

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx