XLaunchUri
Microsoft GDK(게임 개발 키트) 시작 관리자 API는 URI를 호출하여 게임이 사용자 환경을 시작할 수 있게 해주는 메커니즘을 제공합니다.
구문
HRESULT XLaunchUri(
XUserHandle requestingUser,
const char* uri
)
매개 변수
requestingUser _In_opt_
형식: XUserHandle
요청을 수행하는 사용자를 식별하는 핸들을 정의합니다.
uri _In_z_
형식: char*
시작할 URI를 나타내는 문자열입니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
사용자를 대신하여 URI를 시작하며, 단 하나의 메서드인 LaunchUri로만 구성됩니다. 또한 선택적인 사용자 컨텍스트 및 필수 URI를 사용합니다.
성공하면 대상 URI가 시작됩니다. 그렇지 않으면 오류가 반환됩니다. 이 메서드는 시간에 중요한 것으로 간주되지 않으며, 기본 비동기 시스템 작업이 완료될 때까지, 그리고 대상 URI가 시작되었거나 오류가 발생할 때까지 차단됩니다.
지정된 URI의 프로토콜 스키마를 처리할 앱이 없으면 이 스키마를 처리하는 응용 프로그램을 Windows Store에서 검색할지 여부를 묻는 프롬프트를 사용자에게 표시합니다.
요구 사항
헤더: XLauncher.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔