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

解析並驗證遠端資料夾路徑，但不執行平台遊戲註冊。

## 語法

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

### 參數

`_In_z_ remoteDevice`\
類型：**const char\***

遠端裝置的主機名稱或 IP 位址 (例如 `"192.168.1.100"` 或 `"MyDevKit"`)。

`_In_z_ remoteFolderPath`\
類型：**const char\***

遠端裝置上要驗證之資料夾的路徑 (例如 `"D:\\Games\\MyGame"`，或在使用通用根目錄時為 `"MyGame"`)。如果 `remoteFolderPath` 是絕對路徑，則會忽略 `commonRootAlias`。

`_In_opt_z_ commonRootAlias`\
類型：**const char\***

選用。遠端裝置上通用根目錄的別名。傳遞 `nullptr` 以使用預設的通用根目錄位置。

### 傳回值

類型：**HRESULT**

如果成功，則傳回 `S_OK`；否則傳回錯誤碼。

#### 錯誤碼

| 程式碼 | 值 | 描述 | 根本原因 | 疑難排解 |
| - | - | - | - | - |
| E\_OUTSIDEGAMEROOT | 0x8C114001 | 路徑位於 GameRoot 之外；存取遭拒。 | `remoteFolderPath` 是解析到允許之通用根目錄以外位置的相對路徑，或 `commonRootAlias` 不符合遠端裝置上設定的任何通用根目錄。 | 使用解析後位於通用根目錄內的路徑；傳遞存在於遠端裝置上且包含該路徑的 `commonRootAlias` |
| E\_CONNECTIONERROR | 0x8C114014 | 連線錯誤。 | 建立網路連線時發生一般性失敗 (傳輸層級失敗)，與 IP 位址有效性或遠端電腦名稱解析無關 | 檢查遠端電腦上的網路連線、防火牆規則及服務可用性；檢查裝置之間的可見性，裝置之間應能互相 ping；啟用記錄後重試連線。 |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | 無法解析遠端電腦名稱。 | 無法透過 DNS 或本機名稱解析來解析主機名稱。 | 驗證主機名稱拼字、DNS 設定及網路連線。；使用 IP 位址來隔離名稱解析問題。 |
| E\_INVALIDADDRESS | 0x8C114013 | 位址無效。 | 提供的網路位址不正確、格式錯誤或不受支援 (例如 IP 格式錯誤、IP 錯誤或通訊協定不受支援)。 | 確認 IP 位址正確；修正位址格式，並確保使用 IPv4 通訊協定 |
| E\_CLIENTNOTAUTHORIZED | 0x8C114008 | 裝置拒絕用戶端。 | 用戶端不在裝置的受信任用戶端清單中。連線嘗試在完成配對程序之前就已開始 | 成功完成 PIN 配對程序；再次執行連線要求 |
| E\_SERVERNOTAUTHORIZED | 0x8C114009 | 用戶端拒絕裝置。 | 目標裝置不在用戶端的受信任端點清單中。連線嘗試在完成配對程序之前就已開始 | 成功完成 PIN 配對程序；再次執行連線要求 |
| E\_ADMIN\_REQUIRED | 0x8C114016 | 需要系統管理員權限。 | 端點未以提升的權限執行，而該作業需要系統管理員層級的權限 | 以系統管理員身分重新執行端點 |

## 備註

`WdRegisterRemoteXboxGame` 會解析遠端路徑；它不會檢查遊戲套件的內容。

只有當 `remoteFolderPath` 是相對路徑時才會套用驗證。在此情況下，解析後的路徑必須位於允許的通用根目錄內；如果不是，或 `commonRootAlias` 不符合遠端裝置上設定的任何通用根目錄，則會傳回 `E_OUTSIDEGAMEROOT`。絕對的 `remoteFolderPath` 會經過正規化後直接接受，不會檢查是否存在或是否位於根目錄內，因此傳回值 `S_OK` 並不表示該資料夾存在於遠端裝置上。

<Note>目前不需要註冊即可使用 [WdLaunchRemoteGame](/zh-TW/reference/remoting/functions/wdlaunchremotegame) 啟動遊戲。  </Note>

## 需求

| 需求 | 值 |
| - | - |
| **標頭** | WdRemoteIteration.h |
| **程式庫** | wdremoteapi.lib |
| **支援的作業系統** | Windows 11 及更新版本 |
| **支援的架構** | x64, ARM64 |

## 另請參閱

* [WdLaunchRemoteGame](/zh-TW/reference/remoting/functions/wdlaunchremotegame)
* [WdRemoteCopy](/zh-TW/reference/remoting/functions/wdremotecopy)
* [XBOX PC Remote Iteration API 錯誤碼](/zh-TW/reference/remoting/error-codes)
* [XBOX PC Remote Iteration API](/zh-TW/reference/remoting/remoteiteration_members)


## Related topics

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