> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfUserClient::SigninUser

> IXtfUserClient::SigninUser

# IXtfUserClient::SigninUser

メール アドレスで指定されたユーザーをサインインさせ、必要に応じてそのユーザーをコンソールに追加します。

<Info>このリリースでは、パスワード テキストはこのメソッドによってネットワーク経由でコンソールに渡される際に暗号化されません。この動作がネットワーク環境で懸念事項となる場合は、[AddUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m) メソッドを使用してコンソールにユーザーを追加してから、コンソール上のサインイン アプリを使用してユーザーをサインインさせ、ユーザーのパスワードを保存してください (サインイン アプリはパスワードを暗号化してネットワーク経由で送信します)。その後、パスワードを渡さずにこのメソッドを使用してサインインできます。</Info>

<a id="syntaxSection" />

## 構文

```cpp theme={null}
public:
HRESULT SigninUser(
         LPCWSTR emailAddress,
         LPCWSTR password,
         BOOL bStorePassword,
         UINT32 *pUserId
)  
```

<a id="ID4E1" />

<a id="parametersSection" />

### パラメーター

*emailAddress*\
型: LPCWSTR

ユーザーのメール アドレス。

*password*\
型: LPCWSTR

サインインに使用するパスワード。このユーザーのパスワードがコンソールに保存されている場合は、保存されたパスワードでサインインするために `nullptr` を渡します。

*bStorePassword*\
型: BOOL

TRUE の場合、指定されたパスワードを後で使用するためにコンソールに保存します。

*pUserId*\
型: UINT32 \*

サインインに成功した場合、ユーザーのユーザー ID を指します。

<a id="ID4EDB" />

<a id="retvalSection" />

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

<a id="remarks" />

<a id="remarksSection" />

## 解説

ユーザーが既にサインインしている場合、このメソッドの呼び出しは効果がありません。

このメソッドは、次のエラー コードを返す可能性があります。

| エラー コード    | 意味                                                              |
| ---------- | --------------------------------------------------------------- |
| 0x80048823 | メール アドレスが有効ではありません。                                             |
| 0x8004882E | 指定されたユーザーのパスワードがコンソールに保存されていません。サインイン操作の一部としてパスワードを指定する必要があります。 |
| 0x80048821 | ユーザーに指定されたパスワードが無効です。                                           |
| 0x8015DC16 | ユーザーは別のコンソールでサインインしています。                                        |

ユーザー ID を指定してユーザーをサインインさせるには、[SigninUserId](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m) を使用します。

ユーザーをサインアウトさせるには、[SignoutUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m) または [SignoutUserId](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m) を使用します。

<a id="requirementsSection" />

## 要件

**ヘッダー:** xtfuser.h

**ライブラリ:** xtfuser.lib

**対応プラットフォーム:** Windows (XBOX コンソール ツール用)

<a id="seealsoSection" />

## 関連項目

[IXtfUserClient インターフェイス](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)


## Related topics

- [IXtfUserClient::SigninUserId](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUserId](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUser](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::AddUser メソッド](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteUser](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteuser-ixtfuserclient-xtfuser-xbox-windows-m.md)