Chiavi e voci del Registro di sistema per un archivio online di tipo 1

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Per rendere disponibile un archivio online di tipo 1 in Lettore multimediale Windows, il provider dell'archivio online deve creare le sottochiave e le voci del Registro di sistema seguenti nel computer dell'utente.

[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"

Nota

L'impostazione del valore di DllSurrogate sulla stringa vuota indica che il runtime COM caricherà il plug-in dell'archivio online nel surrogato della DLL predefinito, dllhost.exe.

Nella sintassi del Registro di sistema precedente i simboli in corsivo sono segnaposto per i nomi e gli identificatori univoci globali (GUID) specifici dell'archivio online. Nella tabella seguente vengono descritti i segnaposto.

Segnaposto	Descrizione
Keyname	Stringa concordata tra Microsoft e l'archivio online. Questa stringa identifica in modo univoco l'archivio online. Esempio: "Proseware"
flags	Un or bit per bit di uno o più flag di funzionalità plug-in Questi flag specifica se Lettore multimediale Windows deve chiamare metodi specifici di IWMPContentPartner. Per informazioni sui flag supportati, vedere la tabella dei flag di funzionalità plug-in che seguono questa tabella. Esempio: 00000058
Clsid	GUID che è l'identificatore di classe (CLSID) per la classe che implementa IWMPContentPartner nel plug-in dell'archivio online. Questo GUID deve essere in formato registro, completo delle parentesi graffe. Formato: {xxxxxxxx-xxxx-xxxx-xxxx-xxx}
Friendlyname	Nome descrittivo per l'archivio online. Esempio: "Proseware Music Service"
appid	GUID che è l'identificatore dell'applicazione (AppID) per il plug-in dell'archivio online. Questo GUID deve essere in formato registro, completo delle parentesi graffe. Formato: {xxxxxxxx-xxxx-xxxx-xxxx-xxx}
plugName	Nome per il plug-in del negozio online. Esempio: "Plug-in partner contenuto proseware"
className	Nome della classe che implementa IWMPContentpartner nel plug-in del negozio online. Esempio: "CProsewarePartner"
Modulename	Percorso completo della DLL che implementa il plug-in dell'archivio online. Esempio: "C:\Program Files\Proseware\ProsewarePartner.dll"
Threading	Tipo di appartamento in cui viene eseguito il plug-in. "ThreadingModel"="Apartment" indica che il plug-in viene eseguito in un appartamento a thread singolo (STA). "ThreadingModel"="Free" indica che il plug-in viene eseguito nell'appartamento multithreaded (MTA).

Nella tabella seguente vengono descritti i flag di funzionalità plug-in.

Flag	valore	Descrizione
SUBSCRIPTION_CAP_BACKGROUNDPROCESSING	0x8	Lettore multimediale Windows deve chiamare IWMPContentPartner::Notify per informare il plug-in quando deve avviare e arrestare l'elaborazione in background.
SUBSCRIPTION_CAP_DEVICEAVAILABLE	0x10	Lettore multimediale Windows deve chiamare IWMPContentPartner::UpdateDevice.
SUBSCRIPTION_CAP_IS_CONTENTPARTNER	0x40	Informa Lettore multimediale Windows che il plug-in implementa l'interfaccia IWMPContentPartner. Tutti i plug-in dell'archivio online di tipo 1 devono impostare questo flag.
SUBSCRIPTION_CAP_ALTLOGIN	0x80	Informa Lettore multimediale Windows che il plug-in supporta un account di accesso alternativo. Se il plug-in supporta un account di accesso alternativo, Lettore multimediale Windows recupera l'URL di accesso alternativo e didascalia chiamando IWMPContentPartner::GetItemInfo.

Voci del Registro di sistema per sviluppo e test

Quando si inizia a sviluppare l'archivio online, Microsoft fornisce due chiavi: una chiave di test e una chiave di produzione. Durante la fase di sviluppo e test, l'archivio online verrà visualizzato in Lettore multimediale Windows solo se la chiave di test o la chiave di produzione si trova nel Registro di sistema nel computer dell'utente. Per altre informazioni sulle chiavi di test e produzione, vedere Test e Chiavi di produzione per un archivio online di tipo 1.

Inserire il test o la chiave di produzione nel percorso seguente nel Registro di sistema.

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

Si noti che il valore della voce del Registro di sistema TestParameter può specificare più chiavi di test o di produzione. Si supponga, ad esempio, che Proseware abbia una chiave di test "1234" e Contoso abbia una chiave di test di "2345". La voce del Registro di sistema seguente specifica che gli archivi di test per Proseware e Contoso verranno visualizzati in Lettore multimediale Windows.

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

Voce del Registro di sistema ActiveService

Quando l'utente attiva un archivio online, Lettore multimediale Windows scrive informazioni nel Registro di sistema che identifica l'archivio online attivo. Lettore multimediale Windows inserisce le informazioni nel percorso seguente nel Registro di sistema nel computer dell'utente.

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

Nella sintassi del Registro di sistema precedente serviceInfo è un segnaposto per una stringa contenente informazioni descrittive sull'archivio online attivo.

Argomenti correlati

Riferimento per negozi online di tipo 1