XStoreRegisterGameLicenseChanged

  • [アーティクル]

タイトル ライセンス変更イベントに対するコールバックを登録します。 これは、実行中のタイトルのライセンスに対する変更にのみ適用され、永続型 (DLC) ライセンスには適用されません。

構文

HRESULT XStoreRegisterGameLicenseChanged(  
         XStoreContextHandle storeContextHandle,  
         XTaskQueueHandle queue,  
         void* context,  
         XStoreGameLicenseChangedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)

パラメーター

storeContextHandle _In_
型: XStoreContextHandle

XStoreCreateContext によって返されるユーザーの Microsoft Store コンテキスト ハンドル。

queue _In_
型: XTaskQueueHandle

非同期の作業を処理するための非同期キュー。

context _In_opt_
型: void*

コールバックに渡されるゲームで定義されたコンテキスト。

callback _In_
型: XStoreGameLicenseChangedCallback*

登録するコールバック。

token _Out_
型: XTaskQueueRegistrationToken*

成功した場合、コールバックの識別に使用されるトークンが格納されます。

戻り値

型: HRESULT

HRESULT 成功またはエラー コード。

解説

この関数は、XStoreGameLicenseChangedCallback によって定義されたコールバック関数を登録します。 登録された関数は、次のゲーム ライセンス変更イベントが発生したときに呼び出されます。 このイベントは、現在のゲームに関連する購入がこのデバイスで実行されたとき、またはゲームのライセンスが更新されて、ゲームが評価版ライセンスから完全版ライセンスに移行したときに発生します。 登録された関数は、登録の操作によって呼び出されることはありません。 メモリ リークを回避するために、コールバック関数の終了時に XStoreUnregisterGameLicenseChanged を呼び出す必要があります。

使用例については、「XStoreCreateContext」を参照してください。

要件

ヘッダー: XStore.h (XGameRuntime.h に含まれます)

ライブラリ: xgameruntime.lib

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

関連項目

XStore
XStoreGameLicenseChangedCallback
XStoreUnregisterGameLicenseChanged