XSystemGetAppSpecificDeviceId

呼び出し元のタイトル ID に固有の、本体からの一意の値を返します。

Syntax

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

Parameters

appSpecificDeviceIdSize   _In_
型: size_t appSpecificDeviceId のサイズ (バイト単位)。この値は、XSystem.h で定義されている XSystemAppSpecificDeviceIdBytes 定数以上である必要があります。 appSpecificDeviceId   _Out_writes_bytes_to_(appSpecificDeviceIdSize, *appSpecificDeviceIdUsed)
型: char* アプリケーション固有のデバイス ID を受け取る文字バッファー。 appSpecificDeviceIdUsed   _Out_opt_
型: size_t* 返される appSpecificDeviceIdUsed バッファーのサイズ (バイト単位)。

Return value

型: HRESULT 成功した場合は S_OK、それ以外の場合はエラーコードを返します。エラーコードの一覧については、エラーコードを参照してください。 appSpecificDeviceIdSize が XSystemAppSpecificDeviceIdBytes より小さい値に設定されているために関数が失敗した場合、戻り値は HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) に設定されます。

Remarks

この関数はタイムセンシティブスレッドで呼び出すのは安全ではありません。詳細については、以下を参照してください

タイムセンシティブスレッド。エラーによりアプリケーション固有のデバイス識別子を取得できなかった場合、定数文字列 “00000000000000000000000000000000000000000000” が返されます。アプリケーションでシングルサインオン (SSO) を使用している場合は、この関数から返される ID の代わりに、XSTS SSO トークンのペアワイズ ID を使用する必要があります。

Requirements

ヘッダー: XSystem.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XSystemGetAppSpecificDeviceId

XSystemGetAppSpecificDeviceId

Syntax

Parameters

Return value

Remarks

Requirements

See also

​XSystemGetAppSpecificDeviceId

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

XSystemGetAppSpecificDeviceId

Syntax

Parameters

Return value

Remarks

Requirements

See also