XGameUiShowWebAuthenticationAsync
Web UI を表示する非同期認証要求を開始します。この UI により、ユーザーは実行中のタイトルに資格情報を直接提供することなく、外部の Web サイトやサービスへのアクセスを委任できます。Syntax
Parameters
async _In_型: XAsyncBlock* XAsyncRun に渡される XAsyncBlock へのポインター。 requestingUser _In_
型: XUserHandle Web 認証を要求するユーザーへのハンドル。 requestUri _In_z_
型: char* ユーザーに表示される Web ビューの初期 URI (通常、サービスに対するユーザー認証のためのフィールドを含みます)。要求 URI はセキュアな HTTPS アドレスでなければなりません。 completionUri _In_z_
型: char* Web 認証プロセスの正常な完了を表す URI を示します。Web ビューが completionUri に一致する URI に遷移すると、Web ビューは閉じられ、制御は呼び出し元のタイトルに戻されます。
Return value
型: HRESULT 非同期呼び出しの HRESULT の成功またはエラー コード。 結果を取得するには、AsyncBlock コールバック内、または AsyncBlock の完了後に xgameuishowwebauthenticationresultsize と xgameuishowwebauthenticationresult を呼び出します。Remarks
この非同期タスクが実行されると、システムはユーザーに Web ビューを (現在のアプリケーションに重ねて) 提示します。ユーザーはそれを操作するか、戻るボタンを押して閉じることができます。これにより、ユーザーは OAuth を使用して外部の Web サイトやサービスに対する認可権限を付与できます。ソーシャル メディアでゲーム内ハイライトを共有するためのゲーム認証、外部プロバイダーへのユーザー データの要求など、さまざまなシナリオで使用できます。 認証要求の結果は XGameUiWebAuthenticationResultData オブジェクトに格納され、XGameUiShowWebAuthenticationResult メソッドから返されます。 completionUri への遷移の結果として Web ビューが閉じられた場合、結果データ構造体の responseStatus フィールドはS_OK になります。
ユーザーがキャンセルするか、Web ビューを手動で閉じた場合、結果データ構造体の responseStatus フィールドは E_CANCELLED になります。
Example
次のコード例は、Facebook を使用して OAuth を実行する方法を示しています。この例では、コードを簡潔にするためにメモリ割り当てのエラー処理は含まれていません。Requirements
ヘッダー: XGameUI.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体See also
XGameUI XGameUiShowWebAuthenticationWithOptionsAsync XGameUiShowWebAuthenticationResultSizeXGameUiShowWebAuthenticationResult
XGameUiWebAuthenticationResultData
非同期プログラミング モデル
