XUserGetTokenAndSignatureResult
XUserGetTokenAndSignatureAsync 호출의 결과를 가져옵니다.
HRESULT XUserGetTokenAndSignatureResult(
XAsyncBlock* async,
size_t bufferSize,
void* buffer,
XUserGetTokenAndSignatureData** ptrToBuffer,
size_t* bufferUsed
)
async _Inout_
형식: XAsyncBlock*
호출의 상태를 폴링하고 호출 결과를 검색하기 위해 사용할 수 있는 XAsyncBlock입니다.
bufferSize _In_
형식: size_t
buffer 매개 변수에 있는 버퍼 크기입니다.
buffer _Out_writes_bytes_to_(bufferSize,bufferUsed)
형식: void
XUserGetTokenAndSignatureAsync 호출의 결과를 포함합니다.
ptrToBuffer _Outptr_
형식: XUserGetTokenAndSignatureData**
반환 시, prtToBuffer는 buffer 매개 변수에 지정한 버퍼를 가리킵니다. 매개 변수는 buffer에 형식이 지정된 포인터를 제공하며, 독립적으로 해제될 필요가 없습니다.
bufferUsed _Out_opt_
형식: size_t*
buffer 매개 변수에 기록된 바이트 수입니다.
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.
웹 요청에 대한 xtokens 및 서명을 비동기적으로 검색하려면, XUserGetTokenAndSignatureAsync를 호출합니다.
XUserGetTokenAndSignatureAsync 호출 결과를 저장하는 데 필요한 버퍼 크기를 가져오려면, XUserGetTokenAndSignatureResultSize를 호출합니다.
다음 예제에서는 사용자의 토큰 및 서명을 비동기적으로 검색하는 방법을 보여줍니다.
HRESULT RequestTokenComplete(XAsyncBlock* abResult)
{
size_t bufferSize;
RETURN_IF_FAILED(XUserGetTokenAndSignatureResultSize(abResult, &bufferSize));
std::vector<uint8_t> buffer(bufferSize);
XUserGetTokenAndSignatureData* data;
if (SUCCEEDED_LOG(XUserGetTokenAndSignatureResult(abResult, buffer.size(), buffer.data(), &data, nullptr /*bufferUsed*/)))
{
appLog.AddLog("Token: %s\n", data->token);
if (data->signature != nullptr)
{
appLog.AddLog("Signature: %s\n", data->signature);
}
}
return S_OK;
}
HRESULT RequestTokenAsync(
XTaskQueueHandle queue,
const char* url,
bool forceRefresh)
{
auto asyncBlock = std::make_unique<XAsyncBlock>();
ZeroMemory(asyncBlock.get(), sizeof(*asyncBlock));
asyncBlock->queue = queue;
asyncBlock->context = this;
asyncBlock->callback = [](XAsyncBlock* ab)
{
LOG_IF_FAILED(static_cast<User*>(ab->context)->RequestTokenComplete(ab));
delete ab;
};
XUserGetTokenAndSignatureOptions options = XUserGetTokenAndSignatureOptions::None;
if (forceRefresh)
{
WI_SET_FLAG(options, XUserGetTokenAndSignatureOptions::ForceRefresh);
}
static const XUserGetTokenAndSignatureHttpHeader headers[] =
{
{ "Accept", "application/json"},
{ "Why", "Because"},
};
if (SUCCEEDED_LOG(XUserGetTokenAndSignatureAsync(
_handle.get(),
options,
"GET",
url,
ARRAYSIZE(headers),
headers,
0,
nullptr,
asyncBlock.get())))
{
// The call succeeded, so release the std::unique_ptr ownership of XAsyncBlock* since the callback will take over ownership.
// If the call fails, the std::unique_ptr will keep ownership and delete the XAsyncBlock*
asyncBlock.release();
}
return S_OK;
}
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔