Skip to main content

​
XSystemGetAppSpecificDeviceId

Retorna um valor exclusivo do console que é específico para a ID de título do chamador.

​
Sintaxe

​
Parâmetros

appSpecificDeviceIdSize   _In_
Tipo: size_t O tamanho de appSpecificDeviceId, em bytes. Esse valor deve ser igual ou maior que a constante XSystemAppSpecificDeviceIdBytes definida em XSystem.h. appSpecificDeviceId   _Out_writes_bytes_to_(appSpecificDeviceIdSize, *appSpecificDeviceIdUsed)
Tipo: char* O buffer de caracteres que receberá a ID de dispositivo específica do aplicativo. appSpecificDeviceIdUsed   _Out_opt_
Tipo: size_t* O tamanho, em bytes, do buffer appSpecificDeviceIdUsed retornado.

​
Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro. Se a função falhar porque appSpecificDeviceIdSize está definido com um valor menor que XSystemAppSpecificDeviceIdBytes, o valor retornado será definido como HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).

​
Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte
Threads sensíveis ao tempo. A cadeia de caracteres constante “00000000000000000000000000000000000000000000” será retornada nos casos em que o identificador de dispositivo específico do aplicativo não puder ser obtido devido a um erro. Se o seu aplicativo estiver usando Logon Único (SSO), você deverá usar a ID pairwise do token SSO do XSTS em vez da ID retornada por esta função.

​
Requisitos

Cabeçalho: XSystem.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

​
Confira também

Ativando seu kit de desenvolvimento (tópico sob NDA)
XSystemGetXboxLiveSandbodId
XSystem
Last modified on October 6, 2026