DllUnregisterServer-Funktion (olectl.h)

  • Artikel

Weist einen Prozessserver an, nur die Einträge zu entfernen, die über DllRegisterServer erstellt wurden.

Syntax

HRESULT DllUnregisterServer();

Rückgabewert

Diese Funktion kann die Standardrückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Registrierungseinträge wurden erfolgreich gelöscht.
S_FALSE
 Das Aufheben der Registrierung der bekannten Einträge dieses Servers war erfolgreich, aber für die Klassen dieses Servers sind noch andere Einträge vorhanden.
SELFREG_E_TYPELIB
 Der Server konnte die Einträge aller Typbibliotheken, die von seinen Klassen verwendet werden, nicht entfernen.
SELFREG_E_CLASS
 Der Server konnte die Einträge aller Objektklassen nicht entfernen.

Hinweise

Der Server darf keine Einträge stören, die er nicht erstellt hat und die derzeit für seine Objektklassen vorhanden sind. Beispielsweise kann der Benutzer zwischen der Registrierung und Der Registrierung eine Treat-As-Beziehung zwischen dieser Klasse und einer anderen Klasse angegeben haben. In diesem Fall kann die Aufhebung der Registrierung alle Einträge mit Ausnahme des TreatAs-Schlüssels und aller anderen Einträge entfernen, die nicht explizit in DllRegisterServer erstellt wurden. Die Registrierungsfunktionen verbieten insbesondere das Löschen einer gesamten aufgefüllten Struktur in der Registrierung. Der Server kann als letzten Schritt versuchen, den CLSID-Schlüssel zu entfernen, aber wenn noch andere Einträge vorhanden sind, bleibt der Schlüssel erhalten.

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 olectl.h
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

Dllregisterserver