Evento External.OnSendMessageComplete

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di 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.

Nota

In questo argomento vengono descritte le funzionalità progettate per l'uso da parte di negozi online. L'uso di questa funzionalità al di fuori del contesto di un negozio online non è supportato.

L'evento OnSendMessageComplete si verifica al termine dell'elaborazione di un messaggio da parte dell'archivio online. Script nella pagina di individuazione inviato in precedenza il messaggio chiamando External.sendMessage.

window.external.OnSendMessageComplete = FunctionName

Valori possibili

Si tratta di una proprietà di sola scrittura che specifica il nome della funzione nello script che Lettore multimediale Windows chiama quando si verifica l'evento.

Parametri

La funzione che gestisce questo evento ha i parametri seguenti.

Msg

Stessa stringa passata nel parametro Msg di sendMessage.

Param

Stessa stringa passata nel parametro Param di sendMessage.

Risultato

Stringa contenente il risultato della gestione dei messaggi. Vedere la sezione Osservazioni.

Commenti

Il metodo sendMessage chiama IWMPContentPartner::SendMessage, che restituisce in modo asincrono. Ovvero, viene restituito prima che l'archivio online termini l'elaborazione del messaggio. Al termine dell'elaborazione del messaggio, l'archivio online chiama IWMPContentPartnerCallback::SendMessageComplete, che a sua volta chiama il gestore eventi OnSendMessageComplete dello script.

Quando l'archivio online chiama IWMPContentPartnerCallback::SendMessageComplete, fornisce un codice di risultato nel parametro bstrResult . Lettore multimediale Windows non interpreta il codice del risultato. Al contrario, Lettore multimediale Windows passa il codice del risultato al gestore eventi OnSendMessageComplete nel parametro Result.

Nessuno dei parametri (Msg, Param, Result) del gestore eventi OnSendMessageComplete viene interpretato da Lettore multimediale Windows. I parametri hanno un significato solo per lo store online.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11
DLL	Wmp.dll

Vedi anche

Oggetto esterno per gli archivi online di tipo 1

External.sendMessage

IWMPContentPartner::SendMessage

IWMPContentPartnerCallback::SendMessageComplete