Registrierungsschlüssel und Einträge für eine Onlinedatenbank vom Typ 1 Store

Um einen Onlineshop vom Typ 1 in Windows Media Player verfügbar zu machen, muss der Onlinespeicheranbieter die folgenden Registrierungsunterschlüssel und Einträge auf dem Computer des Benutzers erstellen.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MediaPlayer\Subscriptions\keyName]
"Capabilities"=dword:flags
"SubscriptionObjectGUID"=clsid
"FriendlyName"=friendlyName

[HKEY_CLASSES_ROOT\AppID\appid]
@=pluginName
"DllSurrogate"=""

[HKEY_CLASSES_ROOT\CLSID\clsid]
@=className
"AppID"="appid"

[HKEY_CLASSES_ROOT\CLSID\clsid\InprocServer32]
@=moduleName
"ThreadingModel"="threading"

Hinweis

Das Festlegen des Werts von DllSurrogate auf die leere Zeichenfolge gibt an, dass die COM-Runtime das Plug-In des Onlineshops in das standardmäßige DLL-Ersatzzeichen dllhost.exe.

In der obigen Registrierungssyntax sind die symbole italisch Platzhalter für Namen und GUIDs (Globally Unique Identifiers), die für den Onlineshop spezifisch sind. In der folgenden Tabelle werden diese Platzhalter beschrieben.

Platzhalter BESCHREIBUNG
keyName Eine Zeichenfolge, die zwischen Microsoft und dem Onlineshop vereinbart wurde. Diese Zeichenfolge identifiziert den Onlineshop eindeutig. Beispiel: "Proseware"
flags Ein bitweises OR eines oder mehrere Plug-In-Funktionsflags Diese Flags geben an, ob Windows Media Player Methoden von IWMPContentPartner aufrufen sollen. Informationen zu unterstützten Flags finden Sie in der Tabelle der Plug-In-Funktionsflags, die dieser Tabelle folgen. Beispiel: 00000058
Clsid Eine GUID, die der Klassenbezeichner (CLSID) für die Klasse ist, die IWMPContentPartner im Plug-In des Onlineshops implementiert. Diese GUID muss im Registrierungsformat vorliegen und mit geschweiften Klammern vervollständigen. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
Friendlyname Ein Benutzername für den Onlineshop. Beispiel: "Proseware Musik Service"
appid Eine GUID, die der Anwendungsbezeichner (AppID) für das Plug-In des Onlineshops ist. Diese GUID muss im Registrierungsformat vorliegen und mit geschweiften Klammern vervollständigen. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
pluginName Ein Name für das Plug-In des Onlineshops. Beispiel: "Proseware Content Partner Plug-In"
className Der Name der Klasse, die IWMPContentpartner im Plug-In des Onlineshops implementiert. Beispiel: "CProsewarePartner"
Modulename Der vollqualifizierte Pfad zur DLL, die das Plug-In des Onlineshops implementiert. Beispiel: "C: \ Programme \ Proseware \ProsewarePartner.dll"
Threading Der Typ des Apartments, in dem das Plug-In ausgeführt wird. "ThreadingModel"="Apartment" gibt an, dass das Plug-In in einem Singlethread-Apartment (STA) ausgeführt wird. "ThreadingModel"="Free" gibt an, dass das Plug-In im Multithread-Apartment (MTA) ausgeführt wird.

In der folgenden Tabelle werden die Plug-In-Funktionsflags beschrieben.

Flag Wert BESCHREIBUNG
HINTERGRUNDVERARBEITUNG _ FÜR _ ABONNEMENTOBERGRENZE 0x8 Windows Media Player sollte IWMPContentPartner::Notify aufrufen, um das Plug-In darüber zu informieren, wann es die Hintergrundverarbeitung starten und beenden soll.
_ _ ABONNEMENTOBERGRENZE GERÄT VERFÜGBAR 0x10 Windows Media Player sollte IWMPContentPartner::UpdateDevice aufrufen.
_ _ ABONNEMENTOBERGRENZE IST _ CONTENTPARTNER 0x40 Informiert Windows Media Player, dass das Plug-In die IWMPContentPartner-Schnittstelle implementiert. Dieses Flag muss für alle Onlineshop-Plug-Ins vom Typ 1 festgelegt werden.
_ _ ABONNEMENTOBERGRENZE ALTLOGIN 0x80 Informiert Windows Media Player, dass das Plug-In eine alternative Anmeldung unterstützt. Wenn das Plug-In eine alternative Anmeldung unterstützt, ruft Windows Media Player alternative Anmelde-URL und Beschriftung ab, indem IWMPContentPartner::GetItemInfo aufgerufen wird.

Registrierungseinträge für Entwicklung und Tests

Wenn Sie mit der Entwicklung Ihres Onlineshops beginnen, stellt Ihnen Microsoft zwei Schlüssel zur Verfügung: einen Testschlüssel und einen Produktionsschlüssel. Während der Entwicklungs- und Testphase wird Ihr Onlineshop nur dann in Windows Media Player angezeigt, wenn sich Ihr Testschlüssel oder Ihr Produktionsschlüssel in der Registrierung auf dem Computer des Benutzers befindet. Weitere Informationen zu den Test- und Produktionsschlüsseln finden Sie unter Test- und Produktionsschlüssel für einen Typ 1 Online Store.

Platzieren Sie den Test- oder Produktionsschlüssel an folgendem Speicherort in der Registrierung.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services]
"TestParameter" = "key1;key2;...;keyN"

Beachten Sie, dass der Wert des Registrierungseintrags TestParameter mehrere Test- oder Produktionsschlüssel angeben kann. Angenommen, Proseware hat den Testschlüssel "1234", und Contoso hat den Testschlüssel "2345". Der folgende Registrierungseintrag gibt an, dass die Testspeicher für Proseware und Contoso in der Windows Media Player.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services]
"TestParameter" = "1234;2345"

ActiveService-Registrierungseintrag

Wenn der Benutzer einen Onlineshop aktiviert, schreibt Windows Media Player Informationen in die Registrierung, die den aktiven Onlineshop identifizieren. Windows Media Player die Informationen an folgendem Speicherort in der Registrierung auf dem Computer des Benutzers ab.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Subscriptions]
"ActiveService"=serviceInfo

In der obigen Registrierungssyntax ist serviceInfo ein Platzhalter für eine Zeichenfolge, die beschreibende Informationen zum aktiven Onlineshop enthält.

Referenz für Typ 1-Onlineshops