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
最后修改于 2026年8月24日