通过

XSystemGetAppSpecificDeviceId

  • 项目

从主机返回特定于调用方游戏 ID 的唯一值。

语法

HRESULT XSystemGetAppSpecificDeviceId(  
         size_t appSpecificDeviceIdSize,  
         char* appSpecificDeviceId,  
         size_t* appSpecificDeviceIdUsed  
)

参数

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