WdRegisterRemoteXboxGame
解析並驗證遠端資料夾路徑,但不執行平台遊戲註冊。語法
參數
_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;否則傳回錯誤碼。
錯誤碼
備註
WdRegisterRemoteXboxGame 會解析遠端路徑;它不會檢查遊戲套件的內容。
只有當 remoteFolderPath 是相對路徑時才會套用驗證。在此情況下,解析後的路徑必須位於允許的通用根目錄內;如果不是,或 commonRootAlias 不符合遠端裝置上設定的任何通用根目錄,則會傳回 E_OUTSIDEGAMEROOT。絕對的 remoteFolderPath 會經過正規化後直接接受,不會檢查是否存在或是否位於根目錄內,因此傳回值 S_OK 並不表示該資料夾存在於遠端裝置上。
目前不需要註冊即可使用 WdLaunchRemoteGame 啟動遊戲。
