Registrieren von DLL-Systemsteuerung-Elementen
Hinweis
In den aktuellen Implementierungsrichtlinien ist festgelegt, dass neue Systemsteuerung Elemente als .exe Dateien implementiert werden sollten, anstatt .cpl Dateien. Die folgenden Informationen sind hauptsächlich für Legacyzwecke enthalten.
Systemsteuerung Elemente, die in einer DLL implementiert sind, die die CPlApplet-Funktion exportiert, haben andere Registrierungsanforderungen als .exe Dateien. Ab Windows XP sollten neue Systemsteuerung Element-DLLs im Ordner der zugehörigen Anwendung unter dem Ordner Programme installiert werden. Elemente, die im System32-Verzeichnis mit einer .cpl-Erweiterung gespeichert sind, müssen nicht registriert werden. sie werden automatisch im Systemsteuerung angezeigt. Alle anderen Systemsteuerung Elemente, die CPlApplet verwenden, müssen auf zwei Arten registriert werden:
- Wenn das element Systemsteuerung für alle Benutzer verfügbar sein soll, registrieren Sie den Pfad auf Computerbasis, indem Sie dem HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Systemsteuerung\Cpls-Unterschlüssel einen REG_EXPAND_SZ Wert hinzufügen, der auf den DLL-Pfad festgelegt ist.
- Wenn das Systemsteuerung Elements benutzerbezogen verfügbar sein soll, verwenden Sie HKEY_CURRENT_USER als Stammschlüssel anstelle von HKEY_LOCAL_MACHINE.
In den folgenden beiden Beispielen wird das Element MyCplApp Systemsteuerung registriert. Die DLL heißt MyCpl.cpl und befindet sich im Anwendungsverzeichnis MyCorp\MyApp . In diesem ersten Beispiel wird die Registrierung pro Computer veranschaulicht.
Anweisungen
Schritt 1:
Fügen Sie diese Informationen zur Registrierung hinzu, um das Vorhandensein der .cpl datei zu registrieren.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Cpls
MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl
Schritt 2:
Windows Vista und höher: Fügen Sie diese zusätzlichen Informationen zur Registrierung hinzu, um eine GUID für das Systemsteuerung-Element bereitzustellen.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.AppId
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}
Durch Generieren einer GUID zum eindeutigen Identifizieren des Systemsteuerung Elements können Sie Aufgabenlinks zum Systemsteuerung hinzufügen. Ohne diese GUID gibt es keine Möglichkeit, die Aufgabenlinks dem Systemsteuerung-Element zuzuordnen. Weitere Informationen finden Sie unter Erstellen von durchsuchbaren Aufgabenlinks für ein Systemsteuerung Element.
Schritt 3:
Windows Vista und höher: Fügen Sie der Registrierung die folgenden Informationen hinzu, um einen kanonischen Namen für das Element zu erstellen.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ApplicationName
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl
Durch Hinzufügen eines kanonischen Namens können Benutzer das Systemsteuerung-Element über eine Befehlszeile starten, indem sie eingebencontrol.exe /name MyCorporation.MyCpl. Dies ermöglicht es auch, eine Implementierung von einer .cpl-Datei später in eine .exe-Datei zu ändern, ohne dass Programme aufgerufen werden müssen, um Änderungen vorzunehmen, da sie das Element über seinen kanonischen Namen weiterhin öffnen können. Weitere Informationen zu kanonischen Namen finden Sie unter Ausführen von Systemsteuerung Elementen.
Schritt 4:
Windows Vista und höher: Fügen Sie der Registrierung die folgenden Informationen hinzu, um einer oder mehreren Kategorien ein Systemsteuerung Element zuzuweisen.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ControlPanel.Category
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
Windows XP: Fügen Sie der Registrierung die folgenden Informationen hinzu, um einer oder mehreren Kategorien ein Systemsteuerung Element zuzuweisen.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
{305CA226-D286-468e-B848-2B2E8E697B74} 2
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
In diesem Beispiel wird das Element der Kategorie 3 zugewiesen, d. h. Netzwerk und Internet. Um ein Element mehreren Kategorien hinzuzufügen, geben Sie die Liste als REG_SZ durch Kommas getrennten Wert an, z. B. "3,8". Werte können als dezimal oder hexadezimal angegeben werden. Beachten Sie, dass das Hinzufügen eines Elements zu mehreren Kategorien nur in Windows XP Service Pack 2 (SP2) und höher möglich ist. Alle möglichen Werte finden Sie unter Zuweisen Systemsteuerung Kategorien.
Schritt 5:
Windows Vista und höher: Fügen Sie der Registrierung die folgenden Informationen hinzu, um eine XML-Datei zu erstellen, um Aufgabenlinks für das Element zu speichern. Der Wert muss ein REG_SZ Pfad wie hier gezeigt oder eine Modul- und Ressourcen-ID (z. B. "C:\Program Files\MyCorp\MyApp\MyApp.exe,-31") sein, wenn es sich um eine eingebettete Ressource handelt. Der Speicherort der XML-Datei sollte vollständig angegeben werden. Eine Umgebungsvariable wie %ProgramFiles% kann nicht verwendet werden.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.TasksFileUrl
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] C:\ProgramFiles\MyCorp\MyApp\MyTasks.xml
Weitere Informationen zu Aufgabenlinks und zum Erstellen der XML-Datei zum Speichern finden Sie unter Erstellen durchsuchbarer Aufgabenlinks für ein Systemsteuerung Element.
Zugehörige Themen