CoLoadLibrary, fonction (objbase.h)
Charge une DLL spécifique dans le processus de l’appelant.
CoLoadLibrary équivaut à LoadLibraryEx. CoLoadLibrary n’affecte pas la durée de vie de la bibliothèque.
Syntaxe
HINSTANCE CoLoadLibrary(
[in] LPOLESTR lpszLibName,
[in] BOOL bAutoFree
);
Paramètres
[in] lpszLibName
Nom de la bibliothèque à charger.
[in] bAutoFree
Ce paramètre est conservé à des fins de compatibilité avec les applications 16 bits, mais il est ignoré.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle pour la bibliothèque chargée ; sinon, elle est NULL.
Remarques
La fonction CoGetClassObject n’appelle pas CoLoadLibrary. CoLoadLibrary charge une DLL spécifiée par le paramètre lpszLibName dans le processus qui a appelé CoGetClassObject. Les conteneurs ne doivent pas appeler CoLoadLibrary directement.
En interne, un nombre de références est conservé sur la DLL chargée à l’aide de CoLoadLibrary pour incrémenter le nombre et de la fonction CoFreeLibrary pour le décrémenter.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | objbase.h |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |
| Ensemble d’API | ext-ms-win-com-ole32-l1-1-5 (introduit dans Windows 10, version 10.0.15063) |