System.Win.ComServ.DllCanUnloadNow
Delphi
function DllCanUnloadNow: HResult;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.Win.ComServ.pas | System.Win.ComServ | System.Win.ComServ |
Beschreibung
Teilt Windows mit, ob der In-Process-Server, der diese Funktion exportiert, aus dem Speicher entfernt werden kann.
DllCanUnloadNow darf nicht direkt aufgerufen werden. Diese Funktion wird von ActiveX-Servern (DLLs) exportiert und vom Betriebssystem aufgerufen. Sie zeigt an, ob der Server aus dem Speicher entfernt werden kann, weil er nicht mehr in Gebrauch ist. Eine DLL ist nicht mehr in Gebrauch, wenn sie keine vorhandenen Objekte verwaltet (der Referenzzähler für alle Objekte der DLL ist in diesem Fall 0).
Die Rückgabewerte von DllCanUnloadNow lauten wie folgt:
Wert | Bedeutung |
---|---|
S_OK |
Die DLL kann aus dem Speicher entfernt werden. |
S_FALSE |
Die DLL kann jetzt nicht aus dem Speicher entfernt werden. |
Anmerkung: DllCanUnloadNow ist eine von vier Funktionen in der Unit ComServ, die jeder In-Process-ActiveX-Server exportieren muss, damit eine korrekte Verwaltung der Server-Ressourcen durch Windows möglich ist. Die drei anderen Funktionen sind DllGetClassObject, DllRegisterServer und DllUnregisterServer.