대상 URL에 대한 HTTPS 호출에 권한을 부여하는 데 필요한 X 토큰 및 서명을 비동기적으로 검색하는 API입니다. 파트너 센터의권한 부여 필요 타이틀 Single Sign-On 페이지에 대상 URL에 연결된 신뢰 당사자가 있는 경우 X 토큰 및 서명을 반환합니다. 요청을 하기 전에 API의 결과 버전 에서 HTTPS 호출의 권한 부여 및 서명 헤더에 X 토큰 및 서명 값을 추가합니다.
구문
HRESULT XUserGetTokenAndSignatureUtf16Async(
XUserHandle user,
XUserGetTokenAndSignatureOptions options,
const wchar_t* method,
const wchar_t* url,
size_t headerCount,
const XUserGetTokenAndSignatureUtf16HttpHeader* headers,
size_t bodySize,
const void* bodyBuffer,
XAsyncBlock* async
)
매개 변수
user _In_
형식: XUserHandle
웹 요청 대상인 사용자에 대한 핸들입니다.
options _In_
형식: XUserGetTokenAndSignatureOptions
사용자 토큰 및 서명을 검색하기 위한 옵션입니다.
method _In_z_
형식: wchar_t*
웹 요청의 메서드 형식(유니코드)입니다.
url _In_z_
형식: wchar_t*
HTTPS 요청의 대상 URL입니다. HTTPS 요청에 전체 URL 문자열을 사용합니다. URL을 축약하지 마세요.
headerCount _In_
형식: size_t
headers 매개 변수에 있는 헤더 수입니다.
headers _In_reads_opt_(headerCount)
형식: XUserGetTokenAndSignatureUtf16HttpHeader*
웹 요청의 헤더입니다.
bodySize _In_
형식: size_t
bodyBuffer 매개 변수에 있는 버퍼 크기입니다.
bodyBuffer _In_reads_bytes_opt_(bodySize)
형식: void*
웹 요청의 본문이 포함된 버퍼입니다.
async _Inout_
형식: XAsyncBlock*
호출의 상태를 폴링하고 호출 결과를 검색하기 위해 사용할 수 있는 XAsyncBlock입니다.
반환 값
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.
비고
XUserGetTokenAndSignatureUtf16Async 함수는 XUserGetTokenAndSignatureOptions 열거형 인수를 사용하여 웹 요청에 대한 유니코드 X 토큰 및 서명을 비동기적으로 검색합니다.
XUserGetTokenAndSignatureUtf16Async 호출 결과를 검색하려면, XUserGetTokenAndSignatureUtf16Result를 호출합니다.
XUserGetTokenAndSignatureUtf16Async 호출 결과를 저장하는 데 필요한 버퍼 크기를 가져오려면, XUserGetTokenAndSignatureUtf16ResultSize를 호출합니다.
요건
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Steam Deck, Xbox One 제품군 콘솔 및 Xbox Series 콘솔