Shell-Erweiterungshandler registrieren

Ein Shell-Erweiterungshandlerobjekt muss registriert werden, bevor die Shell es verwenden kann. Dieses Thema enthält eine allgemeine Erläuterung zum Registrieren eines Shell-Erweiterungshandlers.

Jedes Mal, wenn Sie einen Shell-Erweiterungshandler erstellen oder ändern, ist es wichtig, das System darüber zu informieren, dass Sie eine Änderung vorgenommen haben. Rufen Sie dazu SHChangeNotify auf, und geben Sie das SHCNE_ASSOCCHANGED-Ereignis an. Wenn Sie SHChangeNotify nicht aufrufen, wird die Änderung möglicherweise erst erkannt, wenn das System neu gestartet wird.

Es gibt einige zusätzliche Faktoren, die für Windows 2000-Systeme gelten. Ausführliche Informationen finden Sie im Abschnitt "Registrieren von Shell-Erweiterungshandlern für Windows 2000 Systems".

Wie bei allen COM-Objekten (Component Object Model) müssen Sie eine GUID für den Handler mithilfe eines Tools wie Guidgen.exeerstellen, das mit dem Windows Software Development Kit (SDK) bereitgestellt wird. Erstellen Sie unter HKEY_CLASSES_ROOT\CLSID einen Unterschlüssel, dessen Name die Zeichenfolgenform dieser GUID ist. Da Shell-Erweiterungshandler In-Process-Server sind, müssen Sie auch einen InprocServer32-Unterschlüssel unter diesem GUID-Unterschlüssel erstellen, wobei der Wert (Standardwert) auf den Pfad der DLL des Handlers festgelegt ist. Verwenden Sie das Apartment-Threadingmodell. Hier sehen Sie ein Beispiel:

HKEY_CLASSES_ROOT
   CLSID
      {00021500-0000-0000-C000-000000000046}
         InprocServer32
            (Default) = %windir%\System32\Example.dll
            ThreadingModel = Apartment

Jedes Mal, wenn die Shell eine Aktion ausführt, die einen Shell-Erweiterungshandler umfassen kann, überprüft sie den entsprechenden Registrierungsunterschlüssel. Der Unterschlüssel, unter dem ein Erweiterungshandler registriert ist, steuert, wann er aufgerufen wird. Beispielsweise ist es üblich, einen Kontextmenühandler zu verwenden, der aufgerufen wird, wenn die Shell ein Kontextmenü für ein Element eines Dateityps anzeigt. In diesem Fall muss der Handler unter dem ProgID-Unterschlüssel des Dateityps registriert werden.

In diesem Thema werden die folgenden Themen behandelt:

• Handlernamen
• Vordefinierte Shellobjekte
• Beispiel für eine Erweiterungshandlerregistrierung
  • Registrieren von Shell-Erweiterungshandlern
• Verwandte Themen

Handlernamen

Um einen Shell-Erweiterungshandler zu aktivieren, erstellen Sie einen Unterschlüssel mit dem Unterschlüsselnamen des Handlers (siehe unten) unter dem ShellEx-Unterschlüssel der ProgID (für Dateitypen) oder den Shell-Objekttypnamen (für predefined_shell_objects).

Wenn Sie beispielsweise einen Kontextmenüerweiterungshandler für MyProgram.1 registrieren möchten, erstellen Sie zunächst den folgenden Unterschlüssel:

HKEY_CLASSES_ROOT
   MyProgram.1
      ShellEx
         ContextMenuHandlers

Erstellen Sie für die folgenden Handler einen Unterschlüssel unter dem Unterschlüssel "Handler Subkey name", der als Zeichenfolgenversion des Klassenbezeichners (CLSID) der Shell-Erweiterung bezeichnet wird. Mehrere Erweiterungen können unter dem Namen des Handlerunterschlüssels registriert werden, indem mehrere Unterschlüssel erstellt werden.

Für die folgenden Handler ist der Standardwert des Schlüssels "Handler Subkey Name" die Zeichenfolgenversion der CLSID der Shell-Erweiterung. Für diese Handler kann nur eine Erweiterung registriert werden.

Die angegebenen Unterschlüssel zum Hinzufügen von An Startmenü anheften und An Taskleiste anheften zum Kontextmenü eines Elements sind nur für Dateitypen erforderlich, die den Eintrag IsShortCut enthalten.

Vordefinierte Shellobjekte

Die Shell definiert zusätzliche Objekte unter HKEY_CLASSES_ROOT , die auf die gleiche Weise wie Dateitypen erweitert werden können. Wenn Sie beispielsweise einen Eigenschaftenblatthandler für alle Dateien hinzufügen möchten, können Sie sich unter dem Unterschlüssel "PropertySheetHandlers" registrieren.

HKEY_CLASSES_ROOT
   *
      shellex
         PropertySheetHandlers

Die folgende Tabelle enthält die verschiedenen Unterschlüssel von HKEY_CLASSES_ROOT , unter denen Erweiterungshandler registriert werden können. Beachten Sie, dass viele Erweiterungshandler nicht unter allen aufgelisteten Unterschlüsseln registriert werden können. Weitere Details finden Sie in der Dokumentation des jeweiligen Handlers.

Hinweise

• Der Zugriff auf das Kontextmenü des Dateiordners erfolgt durch Klicken mit der rechten Maustaste in einem Dateiordner, jedoch nicht über den Inhalt des Ordners.
• "Verben" sind spezielle Befehle, die unter HKEY_CLASSES_ROOT\Subkey\Shell\Verb registriert sind.
• Für den Netzwerktyp\\# ist "#" ein Netzwerkanbietertypcode im Dezimaltrennzeichen. Der Netzwerkanbietertypcode ist das Hochwort eines Netzwerktyps. Die Liste der Netzwerktypen wird in der Winnetwk.h-Headerdatei (WNNC_NET_*-Werte) angegeben. Beispielsweise ist WNNC_NET_SHIVA 0x00330000, sodass der entsprechende Unterschlüssel HKEY_CLASSES_ROOT\Netzwerktyp\\51 ist.
• "network_provider_name" ist der von WNetGetProviderName angegebene Name eines Netzwerkanbieters, wobei Leerzeichen durch Unterstriche ersetzt werden. Wenn beispielsweise der Microsoft Netzwerknetzwerkanbieter installiert ist, lautet der Anbietername "Microsoft Windows Netzwerk", und die entsprechende network_provider_name ist Microsoft_Windows_Network.

Beispiel für eine Erweiterungshandlerregistrierung

Um einen bestimmten Handler zu aktivieren, erstellen Sie einen Unterschlüssel unter dem Erweiterungshandlertyp-Unterschlüssel mit dem Namen des Handlers. Die Shell verwendet nicht den Namen des Handlers, muss sich jedoch von allen anderen Namen unter diesem Typunterschlüssel unterscheiden. Legen Sie den Standardwert des Namensunterschlüssels auf die Zeichenfolgenform der GUID des Handlers fest.

Im folgenden Beispiel werden Registrierungseinträge veranschaulicht, die Kontextmenü- und Eigenschaftenblatterweiterungshandler mithilfe eines Beispieldateityps ".myp" aktivieren.

HKEY_CLASSES_ROOT
   .myp
      (Default) = MyProgram.1
   CLSID
      {00000000-1111-2222-3333-444444444444}
         InProcServer32
            (Default) = C:\MyDir\MyCommand.dll
            ThreadingModel = Apartment
      {11111111-2222-3333-4444-555555555555}
         InProcServer32
            (Default) = C:\MyDir\MyPropSheet.dll
            ThreadingModel = Apartment
   MyProgram.1
      (Default) = MyProgram Application
      Shellex
         ContextMenuHandler
            MyCommand
               (Default) = {00000000-1111-2222-3333-444444444444}
         PropertySheetHandlers
            MyPropSheet
               (Default) = {11111111-2222-3333-4444-555555555555}

Zugehörige Themen

Shell-Erweiterungshandler werden initialisiert