CoLoadLibrary, fonction (objbase.h)

  • Article

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)

Voir aussi

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx