Skip to main content

XUserGetTokenAndSignatureAsync

대상 URL에 대한 HTTPS 호출을 승인하는 데 필요한 X-token 및 Signature를 비동기적으로 가져오는 API입니다. 타이틀의 Partner Center의 Single Sign-on 페이지에서 대상 URL에 연결된 Relying Party가 있는 경우 X-token 및 Signature를 반환합니다. 요청을 하기 전에 HTTPS 호출의 Authorization 및 Signature 헤더에 API의 Results 버전에서 얻은 X-token 및 Signature 값을 추가합니다.

구문

매개변수

user   _In_
형식: XUserHandle
웹 요청이 대상으로 하는 사용자에 대한 핸들입니다. options   _In_
형식: XUserGetTokenAndSignatureOptions
사용자 토큰 및 서명을 가져오기 위한 옵션입니다. method   _In_z_
형식: char*
웹 요청의 메서드 유형입니다. url   _In_z_
형식: char*
HTTPS 요청의 대상 URL입니다. HTTPS 요청에는 전체 URL 문자열을 사용합니다. URL을 축약하지 마십시오. headerCount   _In_
형식: size_t
headers 매개변수의 헤더 수입니다. headers   _In_reads_opt_(headerCount)
형식: XUserGetTokenAndSignatureHttpHeader*
웹 요청의 헤더입니다. bodySize   _In_
형식: size_t
bodyBuffer 매개변수의 버퍼 크기입니다. bodyBuffer   _In_reads_bytes_opt_(bodySize)
형식: void*
웹 요청의 본문을 포함하는 버퍼입니다. async   _Inout_
형식: XAsyncBlock*
호출의 상태를 폴링하고 호출 결과를 가져오기 위한 XAsyncBlock입니다.

반환값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 Error Codes를 참조하십시오.

설명

XUserGetTokenAndSignatureAsync 호출의 결과를 가져오려면 XUserGetTokenAndSignatureResult를 호출합니다. XUserGetTokenAndSignatureAsync 호출의 결과를 담기 위해 필요한 버퍼 크기를 가져오려면 XUserGetTokenAndSignatureResultSize를 호출합니다. 다음 예제는 사용자의 토큰과 Signature를 비동기적으로 가져오는 방법을 보여줍니다.

요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XUser XUserGetTokenAndSignatureResult XUserGetTokenAndSignatureResultSize
마지막 수정일 2026년 8월 24일