Skip to main content

XLaunchUri

L’API Launcher du Microsoft Game Development Kit (GDK) fournit un mécanisme qui permet aux jeux de lancer une expérience en appelant un URI.

Syntaxe

Paramètres

requestingUser   _In_opt_
Type : XUserHandle
Définit un handle identifiant l’utilisateur qui effectue la demande. uri   _In_z_
Type : char*
Chaîne qui indique l’URI à lancer.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT. Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à délai critique. Pour plus d’informations, consultez Threads à délai critique.
Cette fonction lance une autre application au moyen d’un URI. Elle accepte également un contexte utilisateur facultatif et un URI obligatoire. En cas de réussite, l’URI de destination est lancé. Sinon, une erreur est retournée. Cette méthode n’est pas considérée comme critique en matière de délai et reste bloquée jusqu’à ce que l’opération système asynchrone sous-jacente soit terminée, et que l’URI de destination ait été lancé ou qu’une erreur se soit produite. Si aucune application ne peut gérer le schéma de protocole de l’URI donné, le système affiche une invite demandant à l’utilisateur s’il souhaite rechercher dans le Windows Store une application qui gère ce schéma.

Lancement en arrière-plan

Sur console, les applications Windows universelles qui disposent de la fonctionnalité backgroundMediaPlayback dans leur fichier appxmanifest peuvent être lancées en arrière-plan plutôt qu’au premier plan. Pour ce faire, ajoutez la chaîne “ms-bgm-” au début de votre URI. Par exemple, si votre application multimédia d’arrière-plan répond au protocole “companion-music-app://”, vous pouvez la lancer en arrière-plan avec l’URI “ms-bgm-companion-music-app://”. Lorsque l’application reçoit l’activation, l’URI obtenu à partir de ProtocolActivatedEventArgs n’inclut pas le préfixe “ms-bgm-”. Lorsqu’elle est appelée de cette façon, XLaunchUri n’affiche pas d’invite à l’utilisateur si aucune application appropriée n’est installée. À la place, si votre jeu utilise la version d’avril 2025 du GDK ou une version ultérieure, elle retourne E_GAMEPACKAGE_NO_PACKAGE_IDENTIFIER. Votre code peut vérifier cette valeur de retour et l’utiliser pour afficher à l’utilisateur une interface de correction, au besoin. Sur PC, lorsque XLaunchUri est appelée de cette façon, elle supprime simplement “ms-bgm-” du début de l’URI avant de le lancer normalement. Elle n’a aucun autre effet sur le comportement du système sur PC. Voici un exemple d’appel de XLaunchUri pour lancer une application musicale compagnon :

Configuration requise

En-tête : XLauncher.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XLauncher
Last modified on October 6, 2026