XSystemGetConsoleId
返回当前设备的主机 ID。语法
参数
consoleIdSize _In_类型：size_t consoleId 的大小（以字节为单位）。此值必须等于或大于 XSystem.h 中定义的 XSystemConsoleIdBytes 常量。 consoleId _Out_writes_bytes_to_(consoleIdSize,*consoleIdUsed)
类型：char* 将接收主机 ID 的字符缓冲区。 consoleIdUsed _Out_opt_
类型：size_t* 返回的 consoleId 缓冲区的大小（以字节为单位）。
返回值
类型：HRESULT 如果成功，则返回 S_OK；否则返回错误代码。有关错误代码列表，请参阅错误代码。如果函数因 consoleIdSize 设置为小于 XSystemConsoleIdBytes 的值而失败，则返回值将设置为 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)。备注
在时间敏感型线程上调用此函数不安全。有关详细信息，请参阅时间敏感型线程。
00000000.00000000.00000000.00000000.00。对于 PC 设备，主机 ID 始终默认为 00000000.00000000.00000000.00000000.00。
在零售版本中，此函数将始终返回 00000000.00000000.00000000.00000000.00。如果游戏需要可以在包括零售版本在内的所有情况下使用的标识符，则有两种可能性：
- 如果你的应用程序使用单一登录 (SSO)，则应使用 XSTS SSO 令牌的成对 ID，而不是此函数返回的 ID。
- 否则，请使用 XSystemGetAppSpecificDeviceId 函数。
要求
头文件： XSystem.h 库： xgameruntime.lib 支持的平台： Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
激活开发工具包（NDA 主题）XSystemGetXboxLiveSandbodId
XSystem