XSystemGetConsoleId
現在のデバイスの本体 ID を返します。Syntax
Parameters
consoleIdSize _In_型: size_t consoleId のサイズ (バイト単位)。この値は、XSystem.h で定義されている XSystemConsoleIdBytes 定数以上である必要があります。 consoleId _Out_writes_bytes_to_(consoleIdSize,*consoleIdUsed)
型: char* 本体 ID を受け取る文字バッファー。 consoleIdUsed _Out_opt_
型: size_t* 返される consoleId バッファーのサイズ (バイト単位)。
Return value
型: HRESULT 成功した場合は S_OK、それ以外の場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。consoleIdSize が XSystemConsoleIdBytes より小さい値に設定されているために関数が失敗した場合、戻り値は HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) に設定されます。Remarks
この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
00000000.00000000.00000000.00000000.00 になります。PC デバイスの場合、本体 ID は常に 00000000.00000000.00000000.00000000.00 が既定値になります。
RETAIL では、この関数は常に 00000000.00000000.00000000.00000000.00 を返します。ゲームで小売環境を含むすべての状況で使用できる識別子が必要な場合、以下の 2 つの選択肢があります:
- アプリケーションでシングル サインオン (SSO) を使用している場合は、この関数から返される ID の代わりに、XSTS SSO トークンのペアワイズ ID を使用してください。
- それ以外の場合は、XSystemGetAppSpecificDeviceId 関数を使用してください。
Requirements
ヘッダー: XSystem.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
開発キットのアクティブ化 (NDA トピック)XSystemGetXboxLiveSandbodId
XSystem