> ## 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.

# WdRegisterRemoteXboxGame

> WdRegisterRemoteXboxGame

# WdRegisterRemoteXboxGame

リモート デバイス上でゲームを登録します。

<Info>`WdRegisterRemoteXboxGame` は現在実装されておらず、呼び出されると S\_OK を返します。API の今後のバージョンで追加される予定です。</Info>

## 構文

```cpp theme={null}
HRESULT WdRegisterRemoteXboxGame(  
         _In_z_ const char* remoteDevice,  
         _In_z_ const char* remoteFolderPath,  
         _In_opt_z_ const char* commonRootAlias  
);  
```

### パラメーター

`_In_z_ remoteDevice`\
Type: **const char\***

リモート デバイスのホスト名または IP アドレス (例: `"192.168.1.100"` または `"MyDevKit"`)。

`_In_z_ remoteFolderPath`\
Type: **const char\***

登録するゲームを含むフォルダーへの、リモート デバイス上のパス (例: `"D:\\Games\\MyGame"`、または共通ルートを使用する場合は `"MyGame"`)。`remoteFolderPath` が絶対パスの場合、`commonRootAlias` は無視されます。

`_In_opt_z_ commonRootAlias`\
Type: **const char\***

省略可能。リモート デバイス上の共通ルート ディレクトリのエイリアス。既定の共通ルート場所を使用するには `nullptr` を渡します。

### 戻り値

Type: **HRESULT**

成功した場合は `S_OK` を返します。それ以外の場合はエラー コードを返します。

#### エラー コード

| コード                     | 値          | 説明                    | 根本原因                                                                                     | トラブルシューティング                                                                                                        |
| ----------------------- | ---------- | --------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| E\_CONNECTIONERROR      | 0x8C114014 | 接続エラー。                | IP アドレスの有効性やリモート マシン名の解決とは無関係の、ネットワーク接続の確立時の一般的な失敗 (トランスポート レベルの失敗)                      | ネットワーク接続、ファイアウォールの規則、リモート マシン上のサービスの可用性を確認してください。デバイス間の可視性を確認してください。デバイスは互いに ping できる必要があります。ログを有効にして接続を再試行してください。 |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | リモート マシン名を解決できませんでした。 | DNS またはローカル名前解決を介してホスト名を解決できません。                                                         | ホスト名のスペル、DNS 構成、ネットワーク接続を確認してください。IP アドレスを使用して名前解決の問題を切り分けてください。                                                   |
| E\_INVALIDADDRESS       | 0x8C114013 | 無効なアドレス。              | 正しくない、不正な形式の、またはサポートされていないネットワーク アドレスが指定されました (例: 不正な IP 形式、間違った IP、またはサポートされていないプロトコル)。 | 正しい IP アドレスを確認してください。アドレスの形式を修正し、IPv4 プロトコルを使用していることを確認してください                                                      |
| E\_CLIENTNOTAUTHORIZED  | 0x8C114008 | デバイスがクライアントを拒否しました。   | クライアントがデバイスの信頼できるクライアントのリストにありません。ペアリング プロセスを完了する前に接続試行が開始されました                          | ピン ペアリング プロセスを正常に完了してください。接続要求を再度実行してください                                                                          |
| E\_SERVERNOTAUTHORIZED  | 0x8C114009 | クライアントがデバイスを拒否しました。   | ターゲット デバイスがクライアントの信頼できるエンドポイントのリストにありません。ペアリング プロセスを完了する前に接続試行が開始されました                   | ピン ペアリング プロセスを正常に完了してください。接続要求を再度実行してください                                                                          |
| E\_ADMIN\_REQUIRED      | 0x8C114016 | 管理者特権が必要です。           | エンドポイントが昇格された特権で実行されておらず、操作には管理者レベルのアクセス許可が必要                                            | エンドポイントを管理者として再実行してください                                                                                            |

## 解説

`WdRegisterRemoteXboxGame` は、リモート デバイス上に展開されたゲーム パッケージを登録することを目的としています。`remoteFolderPath` は、有効なゲーム パッケージを含むフォルダーを指す必要があります。

<Note>[WdLaunchRemoteGame](/reference/remoting/functions/wdlaunchremotegame) でゲームを起動する際、現在は登録は必要ありません。この関数が今後のバージョンで完全に実装されると、XBOX サービスまたは OGAT パッケージングを使用するゲームを起動する前に登録が必要になります。</Note>

## 要件

| 要件                   | 値                   |
| -------------------- | ------------------- |
| **ヘッダー**             | WdRemoteIteration.h |
| **ライブラリ**            | wdremoteapi.lib     |
| **サポートされている OS**     | Windows 11 以降       |
| **サポートされているアーキテクチャ** | x64、ARM64           |

## 関連項目

* [WdLaunchRemoteGame](/reference/remoting/functions/wdlaunchremotegame)
* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [XBOX PC Remote Iteration API エラー コード](/reference/remoting/error-codes)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

- [XBOX PC Remote Iteration API](/ja-jp/reference/remoting/remoteiteration_members.md)
- [WdLaunchRemoteGame](/ja-jp/reference/remoting/functions/wdlaunchremotegame.md)
- [WdResumeRemoteGame](/ja-jp/reference/remoting/functions/wdresumeremotegame.md)
- [WdTerminateRemoteGame](/ja-jp/reference/remoting/functions/wdterminateremotegame.md)
- [WdRemoteCopy](/ja-jp/reference/remoting/functions/wdremotecopy.md)