> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreRegisterGameLicenseChanged

> XStoreRegisterGameLicenseChanged

# XStoreRegisterGameLicenseChanged

為遊戲授權變更事件註冊回呼。
這只適用於執行中遊戲之授權的變更，而不適用於任何耐久性 (DLC) 授權。

## 語法

```cpp theme={null}
HRESULT XStoreRegisterGameLicenseChanged(  
         XStoreContextHandle storeContextHandle,  
         XTaskQueueHandle queue,  
         void* context,  
         XStoreGameLicenseChangedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### 參數

*storeContextHandle*   \_In\_\
類型：XStoreContextHandle

由 [XStoreCreateContext](/zh-TW/reference/system/xstore/functions/xstorecreatecontext) 傳回的使用者市集內容控制代碼。

*queue*   \_In\_\
類型：XTaskQueueHandle

用來處理非同步工作的非同步佇列。

*context*   \_In\_opt\_\
類型：void\*

要傳遞給回呼之由遊戲定義的內容。

*callback*   \_In\_\
類型：XStoreGameLicenseChangedCallback\*

要註冊的回呼。

*token*   \_Out\_\
類型：[XTaskQueueRegistrationToken\*](/zh-TW/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

成功時，包含用來識別回呼的權杖。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

此函式會註冊由 [XStoreGameLicenseChangedCallback](/zh-TW/reference/system/xstore/functions/xstoregamelicensechangedcallback) 定義的回呼函式。
下一次發生遊戲授權變更事件時，就會呼叫已註冊的函式。
當此裝置上發生與目前遊戲相關的購買，或遊戲的授權重新整理且遊戲從試用版授權變更為完整授權時，就會發生此事件。
註冊動作本身不會呼叫已註冊的函式。
為了避免記憶體流失，當您用完回呼函式時，必須呼叫 [XStoreUnregisterGameLicenseChanged](/zh-TW/reference/system/xstore/functions/xstoreunregistergamelicensechanged)。

如需使用範例，請參閱 [XStoreCreateContext](/zh-TW/reference/system/xstore/functions/xstorecreatecontext)。

## 需求

**標頭：** XStore.h (包含在 XGameRuntime.h 中)

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [啟用授權測試](/zh-TW/publishing/xstore-commerce/xstore-licensing-setup)

## 另請參閱

[XStore](/zh-TW/reference/system/xstore/xstore_members)\
[XStoreGameLicenseChangedCallback](/zh-TW/reference/system/xstore/functions/xstoregamelicensechangedcallback)\
[XStoreUnregisterGameLicenseChanged](/zh-TW/reference/system/xstore/functions/xstoreunregistergamelicensechanged)


## Related topics

- [XStoreRegisterGameLicenseChanged](/reference/system/xstore/functions/xstoreregistergamelicensechanged.md)
- [XStoreUnregisterGameLicenseChanged](/reference/system/xstore/functions/xstoreunregistergamelicensechanged.md)
- [XStoreGameLicenseChangedCallback](/reference/system/xstore/functions/xstoregamelicensechangedcallback.md)