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