XGameStreamingGetClientIPAddress
已淘汰。 此 API 自 2604 GDK 版本起已淘汰,並將在未來的 GDK 版本中移除。在目前的 XBOX Cloud Gaming 串流堆疊上,此 API 無法運作,且在成功時會傳回
E_GAMESTREAMING_NO_DATA。如果您的遊戲需要判斷是否在 XBOX Game Streaming 伺服器上執行,或需要使用者的大約地理位置,請改用 XSTS 權杖宣告。語法
參數
client _In_類型:XGameStreamingClientId 正在查詢的串流用戶端。 ipAddressSize _In_
類型:size_t 所提供之
ipAddress 緩衝區的大小上限。此值通常應直接使用 ClientIPAddressMaxBytes。
ipAddress _Out_writes_z_(ipAddressSize)類型:char* 將填入指定用戶端之 IP 位址的緩衝區。
傳回值
類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。可能的錯誤
如需錯誤碼清單,請參閱錯誤碼。
備註
ipAddress 可以是 IPv4 位址 (1.2.3.4) 或 IPv6 位址 (1:2:3:4:5:6:7:8)。如有需要,可以使用 ParseNetworkString 來剖析字串。
傳回的 IP 位址是 XBOX 從串流用戶端收到的位址。如果串流用戶端使用 VPN 或位於 NAT 後方,則使用 IP 位址進行地理位置定位可能會發生問題。
在開發或遠端遊玩案例中,如果串流用戶端與 XBOX 位於同一個私人網路上,可能會傳回私人 IP 位址。
範例
需求
標頭: xgamestreaming.h程式庫: xgameruntime.lib
支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機
