XUserGetTokenAndSignatureOptions
XUserGetTokenAndSignatureAsync のオプション。
構文
enum class XUserGetTokenAndSignatureOptions : uint32_t
{
None = 0x00,
ForceRefresh = 0x01,
AllUsers = 0x02,
}
定数
| 定数 | 説明 |
|---|---|
| None | オプションはありません。 |
| ForceRefresh | 更新を強制します。 |
| AllUsers | すべてのユーザーのトークンと署名を取得します。 |
解説
XUserGetTokenAndSignatureAsync 関数は、XUserGetTokenAndSignatureOptions 列挙型引数を使用して Web 要求の Xtoken と署名を非同期に取得します。
同様に、XUserGetTokenAndSignatureUtf16Async 関数は、XUserGetTokenAndSignatureOptions 列挙型引数を使用して Web 要求の Unicode の Xtoken と署名を非同期に取得します。
次の例は、ユーザーのトークンと署名を非同期で取得する方法を示しています。
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
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体
関連項目
XUserGetTokenAndSignatureAsync