CoLoadLibrary-Funktion (objbase.h)

Lädt eine bestimmte DLL in den Prozess des Aufrufers.

CoLoadLibrary entspricht LoadLibraryEx. CoLoadLibrary wirkt sich nicht auf die Lebensdauer der Bibliothek aus.

Syntax

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

Parameter

[in] lpszLibName

Der Name der bibliothek, die geladen werden soll.

[in] bAutoFree

Dieser Parameter wird aus Gründen der Kompatibilität mit 16-Bit-Anwendungen beibehalten, aber ignoriert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die geladene Bibliothek. Andernfalls ist es NULL.

Hinweise

Die CoGetClassObject-Funktion ruft CoLoadLibrary nicht auf. CoLoadLibrary lädt eine durch den lpszLibName-Parameter angegebene DLL in den Prozess, der CoGetClassObject aufgerufen hat. Container sollten CoLoadLibrary nicht direkt aufrufen.

Intern wird eine Verweisanzahl für die geladene DLL beibehalten, indem CoLoadLibrary verwendet wird, um die Anzahl zu erhöhen, und die CoFreeLibrary-Funktion , um sie zu dekrementieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objbase.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-5 (eingeführt in Windows 10, Version 10.0.15063)

Weitere Informationen

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx