Registrierungsschlüssel und Einträge für einen Typ 1-Onlineshop

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Um einen Onlineshop vom Typ 1 in Windows Medienwiedergabe verfügbar zu machen, muss der Online-Shop-Anbieter 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

Wenn Sie den Wert von DllSurrogate auf die leere Zeichenfolge festlegen, wird angezeigt, dass die COM-Runtime das Plug-In des Online-Shops in das Standard-DLL-Ersatzobjekt dllhost.exe lädt.

In der vorherigen Registrierungssyntax sind die Symbole kursiv Platzhalter für Namen und GLOBALLY UNIQUE Identifiers (GUIDs), die für den Online-Shop spezifisch sind. In der folgenden Tabelle werden diese Platzhalter beschrieben.

Platzhalter BESCHREIBUNG
keyName Eine zwischen Microsoft und dem Online-Shop vereinbarte Zeichenfolge. Diese Zeichenfolge identifiziert den Online-Shop eindeutig. Beispiel: "Proseware"
flags Bitweises ODER eines oder mehrerer Plug-In-Funktionsflags Diese Flags geben an, ob Windows Medienwiedergabe bestimmte Methoden von IWMPContentPartner aufrufen sollen. Informationen zu unterstützten Flags finden Sie in der Tabelle der Plug-In-Funktionsflags in dieser Tabelle. Beispiel: 00000058
Clsid Eine GUID, die den Klassenbezeichner (CLSID) für die Klasse darstellt, die IWMPContentPartner im Plug-In des Onlineshops implementiert. Diese GUID muss im Registrierungsformat mit den geschweiften Klammern vorliegen. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx}
friendlyname Ein Anzeigename für den Onlineshop. Beispiel: "Proseware Music Service"
appid Eine GUID, die den Anwendungsbezeichner (AppID) für das Plug-In des Online-Shops darstellt. Diese GUID muss im Registrierungsformat mit den geschweiften Klammern vorliegen. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx}
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 Online-Shops implementiert. Beispiel: "CProsewarePartner"
moduleName Der vollqualifizierte Pfad zur DLL, die das Plug-In des Onlineshops implementiert. Beispiel: "C:\Program Files\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 Multithreaded Apartment (MTA) ausgeführt wird.

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

Flag Wert BESCHREIBUNG
SUBSCRIPTION_CAP_BACKGROUNDPROCESSING 0x8 Windows Medienwiedergabe sollte IWMPContentPartner::Notify aufrufen, um das Plug-In darüber zu informieren, wann die Hintergrundverarbeitung gestartet und beendet werden soll.
SUBSCRIPTION_CAP_DEVICEAVAILABLE 0x10 Windows Medienwiedergabe sollte IWMPContentPartner::UpdateDevice aufrufen.
SUBSCRIPTION_CAP_IS_CONTENTPARTNER 0x40 Informiert Windows Medienwiedergabe darüber, dass das Plug-In die IWMPContentPartner-Schnittstelle implementiert. Dieses Flag müssen alle Plug-Ins vom Typ 1 des Online-Shops festlegen.
SUBSCRIPTION_CAP_ALTLOGIN 0x80 Informiert Windows Medienwiedergabe, dass das Plug-In eine alternative Anmeldung unterstützt. Wenn das Plug-In eine alternative Anmeldung unterstützt, ruft Windows Medienwiedergabe die alternative Anmelde-URL ab und Untertitel durch Aufrufen von IWMPContentPartner::GetItemInfo.

Registrierungseinträge für Entwicklung und Tests

Wenn Sie mit der Entwicklung Ihres Onlineshops beginnen, stellt Microsoft Ihnen zwei Schlüssel zur Verfügung: einen Testschlüssel und einen Produktionsschlüssel. Während der Entwicklungs- und Testphase wird Ihr Online-Shop nur dann in Windows Medienwiedergabe 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 Ihren Test- oder Produktionsschlüssel am folgenden 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 verfügt über den Testschlüssel "1234" und Contoso über den Testschlüssel "2345". Der folgende Registrierungseintrag gibt an, dass die Testspeicher für Proseware und Contoso in Windows Medienwiedergabe angezeigt werden.

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

ActiveService-Registrierungseintrag

Wenn der Benutzer einen Online-Shop aktiviert, schreibt Windows Medienwiedergabe Informationen in die Registrierung, die den aktiven Onlineshop identifizieren. Windows Medienwiedergabe platziert die Informationen an folgendem Speicherort in der Registrierung auf dem Computer des Benutzers.

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

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

Referenz für Typ 1-Onlineshops