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

# XPackageUnregisterPackageInstalled

> XPackageUnregisterPackageInstalled

# XPackageUnregisterPackageInstalled

取消註冊先前註冊的套件已安裝回呼。

## 語法

```cpp theme={null}
bool XPackageUnregisterPackageInstalled(  
         XTaskQueueRegistrationToken token,  
         bool wait  
)  
```

### 參數

*token*   \_In\_\
類型：[XTaskQueueRegistrationToken](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)

[XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md) 所傳回的權杖。

*wait*   \_In\_\
類型：bool

指出是否要封鎖直到任何擱置中的回呼完成為止。

### 傳回值

類型：bool

如果 *wait* 為 false 且取消註冊仍在擱置中，則傳回 false。否則傳回 true。

## 備註

> [!NOTE]
>
> 在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。

通知的取消註冊行為如下：

* 取消註冊會從已註冊的回呼集合中，移除與權杖相關聯的回呼。
* 如果該回呼權杖沒有任何正在執行的回呼，呼叫會傳回 true。
* 如果有回呼正在執行且 *wait* 為 true，呼叫會封鎖直到正在執行的回呼完成為止。
* 如果有回呼正在執行且 *wait* 為 false，呼叫不會封鎖，但會傳回 false。在權杖的回呼完成之後，權杖會自動取消註冊。

此機制允許下列程式設計模式：

1. 您可以在取消註冊時封鎖，以確保在呼叫取消註冊之後絕不會叫用您的回呼。
2. 您可以選擇不封鎖。若要確保在刪除資料之前回呼都已完成，請定期以 false 作為 *wait* 呼叫取消註冊。當它最後傳回 true 時，表示所有回呼都已完成，您便可刪除狀態。
3. 如果您的回呼不在意是否在取消註冊呼叫期間被叫用，您可以直接為 *wait* 傳遞 false 並忽略傳回值。

下列程式碼範例示範 **XPackageUnregisterPackageInstalled** 的用法：

```cpp theme={null}
void StopListeningForDlc(XTaskQueueRegistrationToken token)
{
    XPackageUnregisterPackageInstalled(token, false);
}  
```

## 需求

**標頭：** XPackage.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[XPackage](https://docs.xbox.com/zh-TW/reference/system/xpackage/xpackage_members.md)\
[如何為 PC 和 XBOX One 建立及使用可下載內容套件 (DLC)](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)


## Related topics

- [XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XTaskQueueRegistrationToken](https://docs.xbox.com/zh-TW/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)
- [XPackage (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xpackage/xpackage_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageInstalledCallback](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackageinstalledcallback.md)