メール アドレスで指定されたユーザーをサインインし、必要に応じてユーザーをコンソールに追加します。
Important
このリリースでは、この方法でネットワークを通して本体に渡された場合、パスワード テキストは暗号化されません。 この動作がネットワーク環境で問題になる場合は、AddUser メソッド を使用して本体にユーザーを追加してから、本体でサインイン アプリを使用してユーザーをサインインし、ユーザー パスワードを保存してください。 (サインイン アプリにより、パスワードはネットワーク上で暗号化されて送信されます)。引き続きこのメソッドを使用して、パスワードを渡さずにサインインできます。
構文
public:
HRESULT SigninUser(
LPCWSTR emailAddress,
LPCWSTR password,
BOOL bStorePassword,
UINT32 *pUserId
)
パラメーター
emailAddress
型: LPCWSTR
ユーザーのメール アドレス。
password
型: LPCWSTR
サインインするために使用するパスワード。 パスワードがこのユーザーの本体に保存されている場合は、nullptr を渡して、保存されたパスワードを使用してサインインします。
bStorePassword
型: BOOL
TRUE の場合、後で使用するため本体に指定されたパスワードを保存します。
pUserId
型: UINT32 *
正常にサインインした場合は、ユーザーのユーザー ID をポイントします。
戻り値
型: HRESULT
HRESULT 成功またはエラー コード。
解説
ユーザーが既にサインインしている場合、このメソッドを呼び出しても効果はありません。
このメソッドは、次のエラーコードを返すことができます。
| エラー コード | 意味 |
|---|---|
| 0x80048823 | 無効なメール アドレスです。 |
| 0x8004882E | 指定されたユーザーのパスワードが本体に保存されていません。 パスワードはサインイン操作の一部として入力する必要があります。 |
| 0x80048821 | 指定されたユーザーのパスワードが無効です。 |
| 0x8015DC16 | ユーザーは別の本体にサインインしています。 |
ユーザー ID を指定してユーザーをサインインするには、SigninUserIdを使用します。
ユーザーをサインアウトするには、SignoutUser または SignoutUserIDを使用します。
要件
ヘッダー: xtfuser.h
ライブラリ: xtfuser.lib
サポートされているプラットフォーム: Windows (Xbox 本体ツール用)