XSystemGetConsoleId
Devuelve el identificador de consola del dispositivo actual.Sintaxis
Parámetros
consoleIdSize _In_Tipo: size_t El tamaño de consoleId, en bytes. Este valor debe ser igual o mayor que la constante XSystemConsoleIdBytes definida en XSystem.h. consoleId _Out_writes_bytes_to_(consoleIdSize,*consoleIdUsed)
Tipo: char* El búfer de caracteres que recibirá el identificador de consola. consoleIdUsed _Out_opt_
Tipo: size_t* El tamaño, en bytes, del búfer consoleId devuelto.
Valor devuelto
Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte Códigos de error. Si la función falla porque consoleIdSize está establecido en un valor menor que XSystemConsoleIdBytes, el valor devuelto se establece en HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).Comentarios
No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
00000000.00000000.00000000.00000000.00. Para los dispositivos PC, el identificador de consola siempre tiene como valor predeterminado 00000000.00000000.00000000.00000000.00.
En RETAIL, esta función siempre devolverá 00000000.00000000.00000000.00000000.00. Si el juego necesita un identificador que se pueda
usar en todas las situaciones, incluida la venta al público, hay dos posibilidades:
- Si su aplicación usa el inicio de sesión único (SSO), debe usar el identificador por pares del token SSO de XSTS en lugar del identificador devuelto por esta función.
- De lo contrario, use la función XSystemGetAppSpecificDeviceId.
Requisitos
Encabezado: XSystem.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
Consulte también
Activación del kit de desarrollo (tema con NDA)XSystemGetXboxLiveSandbodId
XSystem