Skip to main content

​
XSystemGetAppSpecificDeviceId

從主機傳回呼叫端遊戲 ID 專屬的唯一值。

​
語法

​
參數

appSpecificDeviceIdSize   _In_
類型：size_t appSpecificDeviceId 的大小 (以位元組為單位)。此值必須等於或大於 XSystem.h 中定義的 XSystemAppSpecificDeviceIdBytes 常數。 appSpecificDeviceId   _Out_writes_bytes_to_(appSpecificDeviceIdSize, *appSpecificDeviceIdUsed)
類型：char* 將接收應用程式專屬裝置 ID 的字元緩衝區。 appSpecificDeviceIdUsed   _Out_opt_
類型：size_t* 傳回之 appSpecificDeviceIdUsed 緩衝區的大小 (以位元組為單位)。

​
傳回值

類型：HRESULT 如果成功，則傳回 S_OK；否則傳回錯誤碼。如需錯誤碼清單，請參閱錯誤碼。 如果函式因 appSpecificDeviceIdSize 設定為小於 XSystemAppSpecificDeviceIdBytes 的值而失敗， 傳回值會設定為 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)。

​
備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱
時間敏感執行緒。 如果因錯誤而無法取得應用程式專屬裝置識別碼， 將會傳回常數字串 “00000000000000000000000000000000000000000000”。 如果您的應用程式使用單一登入 (SSO)，您應該使用 XSTS SSO 權杖的成對 ID，而不是此函式 傳回的 ID。

​
需求

標頭： XSystem.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

​
另請參閱

啟用您的開發套件 (NDA 主題)
XSystemGetXboxLiveSandbodId
XSystem
Last modified on October 6, 2026