Skip to main content

XLaunchUri

La API Launcher del Microsoft Game Development Kit (GDK) proporciona un mecanismo que permite a los juegos iniciar una experiencia invocando un URI.

Sintaxis

Parámetros

requestingUser   _In_opt_
Tipo: XUserHandle
Define un identificador que identifica al usuario que realiza la solicitud. uri   _In_z_
Tipo: char*
Cadena que indica el URI que se va a iniciar.

Valor devuelto

Tipo: HRESULT Código de error o de éxito HRESULT. Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte Códigos de error.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Esto inicia otra aplicación mediante un URI. También acepta un contexto de usuario opcional y un URI obligatorio. Si se realiza correctamente, se inicia el URI de destino. De lo contrario, se devuelve un error. Este método no se considera crítico en cuanto al tiempo y se bloquea hasta que se completa la operación asincrónica subyacente del sistema y se inicia el URI de destino o se produce un error. Si no existe ninguna aplicación para controlar el esquema de protocolo del URI dado, el sistema muestra un aviso al usuario preguntándole si desea buscar en la Windows Store una aplicación que controle ese esquema.

Inicio en segundo plano

En la consola, las aplicaciones Windows universales que tienen la funcionalidad backgroundMediaPlayback en su archivo appxmanifest se pueden iniciar en segundo plano en lugar de en primer plano. Para ello, anteponga a su URI la cadena “ms-bgm-”. Por ejemplo, si su aplicación multimedia en segundo plano responde al protocolo “companion-music-app://”, podría iniciarla en segundo plano con el URI “ms-bgm-companion-music-app://”. Cuando la aplicación reciba la activación, el URI obtenido de ProtocolActivatedEventArgs no incluirá el prefijo “ms-bgm-”. Cuando se llama de esta manera, XLaunchUri no muestra un aviso al usuario cuando no hay instalada ninguna aplicación adecuada. En su lugar, si su juego usa la versión de abril de 2025 del GDK o posterior, devuelve E_GAMEPACKAGE_NO_PACKAGE_IDENTIFIER. Su código puede comprobar este valor devuelto y usarlo para mostrar al usuario una interfaz de usuario de corrección, según corresponda. En PC, cuando se llama a XLaunchUri de esta manera, simplemente se quita “ms-bgm-” del principio del URI antes de iniciarlo normalmente. No tiene ningún otro efecto en el comportamiento del sistema en PC. Este es un ejemplo de una llamada a XLaunchUri para iniciar una aplicación de música complementaria:

Requisitos

Encabezado: XLauncher.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XLauncher
Última modificación el 28 de agosto de 2026