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) |