Registrierungsschlüssel und -einträge für eine Online-Store vom Typ 2

Hinweis

In diesem Abschnitt werden funktionen beschrieben, die für die Verwendung durch Onlineshops entwickelt wurden. Die Verwendung dieser Funktionalität außerhalb des Kontexts eines Onlineshops wird nicht unterstützt.

Um einen Onlineshop vom Typ 2 in Windows Media Player verfügbar zu machen, muss der Onlineshopanbieter 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\CLSID\clsid]
@=className

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

In der obigen Registrierungssyntax sind die symbole in italic 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 mehrerer Plug-In-Funktionsflags Diese Flags geben an, ob Windows Media Player bestimmte Methoden von IWMPSubscriptionService und IWMPSubscriptionService2aufrufen sollen. Informationen zu unterstützten Flags finden Sie in der Tabelle der Plug-In-Funktionsflags, die auf diese Tabelle folgen. Beispiel: 00000037
Clsid Eine GUID, die der Klassenbezeichner (CLSID) für die Klasse ist, die IWMPSubscriptionService im Plug-In des Onlineshops implementiert. Diese GUID muss das Registrierungsformat aufweisen und die geschweiften Klammern aufweisen. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx}
Friendlyname Ein Anzeigename für den Onlineshop. Beispiel: "Proseware Musik Service"
pluginName Ein Name für das Plug-In des Onlineshops. Beispiel: "Proseware-Dienst-Plug-In"
className Der Name der Klasse, die IWMPSubscriptionService im Plug-In des Onlineshops implementiert. Beispiel: "CProsewareService"
Modulename Der vollqualifizierte Pfad zur DLL, die das Plug-In des Onlineshops implementiert. Beispiel: "C: \ Programme \ Proseware \ProsewareService.dll"

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

Flag Wert BESCHREIBUNG
_ABONNEMENTOBERGRENZE _ ALLOWPLAY 0X1 Windows Media Player sollte IWMPSubscriptionService::allowPlayaufrufen.
_ABONNEMENTOBERGRENZE _ ALLOWCDONNEMENT 0X2 Windows Media Player sollte IWMPSubscriptionService::allowCD Csvaufrufen.
_ABONNEMENTOBERGRENZE _ ALLOWPDATRANSFER 0X4 Windows Media Player sollte IWMPSubscriptionService::allowPDATransferaufrufen.
_ _ ABONNEMENTOBERGRENZE – HINTERGRUNDVERARBEITUNG 0X8 Windows Media Player sollte IWMPSubscriptionService::startBackgroundProcessingaufrufen.
_ _ ABONNEMENTOBERGRENZE GERÄT VERFÜGBAR 0X10 Windows Media Player sollte IWMPSubscriptionService2::d eviceAvailableaufrufen.
_ABONNEMENTOBERGRENZE _ PREPAREFORSYNC 0X20 Windows Media Player sollte IWMPSubscriptionService2::p repareForSyncaufrufen.
_ABONNEMENT V1 _ CAPS 0XF Standard. Dieser Wert wird verwendet, wenn keine registriert ist. Dies entspricht der Kombination von SUBSCRIPTION _ CAP _ ALLOWPLAY, SUBSCRIPTION _ CAP _ ALLOWCDDDA, SUBSCRIPTION _ CAP _ ALLOWPDATRANSFER und SUBSCRIPTION _ CAP _ BACKGROUNDPROCESSING.

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 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 2 Online Store.

Platzieren Sie Ihren 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 den Testschlüssel "2345". Der folgende Registrierungseintrag gibt an, dass die Testspeicher für Proseware und Contoso in Windows Media Player angezeigt werden.

[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 platziert die Informationen am folgenden Speicherort in der Registrierung auf dem Computer des Benutzers.

[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 2-Onlineshops