次の方法で共有

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) を使用している場合は、この関数によって返される ID ではなく、XSTS SSO トークンのペアワイズ ID を使用する必要があります。

要件

ヘッダー: XSystem.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

開発キットのアクティブ化 (NDA トピック)
XSystemGetXboxLiveSandbodId
XSystem