> ## 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.

# XPackageUnregisterInstallationProgressChanged

> XPackageUnregisterInstallationProgressChanged

# XPackageUnregisterInstallationProgressChanged

이전에 등록된 설치 진행률 변경 콜백을 등록 취소합니다.

## 구문

```cpp theme={null}
bool XPackageUnregisterInstallationProgressChanged(  
         XPackageInstallationMonitorHandle installationMonitor,  
         XTaskQueueRegistrationToken token,  
         bool wait  
)  
```

### 매개 변수

*installationMonitor*   \_In\_\
형식: XPackageInstallationMonitorHandle

지정된 콜백을 제거할 설치 모니터입니다.

*token*   \_In\_\
형식: [XTaskQueueRegistrationToken](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

[XPackageRegisterInstallationProgressChanged](/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged)에서 반환한 토큰입니다.

*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)를 참조하세요.</Note>

알림의 등록 취소는 다음과 같이 동작합니다.

* 등록된 콜백 집합에서 등록 취소는 토큰과 연결된 콜백을 제거합니다.
* 해당 콜백 토큰에 대해 실행 중인 콜백이 없으면 호출은 true를 반환합니다.
* 콜백이 실행 중이고 *wait*이 true이면 호출은 실행 중인 콜백이 완료될 때까지 차단됩니다.
* 콜백이 실행 중이고 *wait*이 false이면 호출은 차단되지 않지만 false를 반환합니다. 토큰에 대한 콜백이 완료된 후에는 토큰이 자동으로 등록 취소됩니다.

이 메커니즘을 통해 다음과 같은 코딩 패턴을 사용할 수 있습니다.

1. 등록 취소 호출 후에 콜백이 절대 호출되지 않도록 등록 취소에서 차단할 수 있습니다.
2. 차단하지 않을 수도 있습니다. 데이터를 삭제하기 전에 콜백이 완료되었는지 확인하려면 *wait*을 false로 하여 주기적으로 unregister를 호출합니다. 마침내 true를 반환하면 모든 콜백이 완료된 것이며 상태를 삭제할 수 있습니다.
3. 콜백이 unregister 호출 중에 호출되는지 여부를 신경 쓰지 않는 경우 *wait*에 false를 전달하고 반환 값을 무시하면 됩니다.

예제:

```cpp theme={null}
XPackageUnregisterInstallationProgressChanged(monitor, 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](/reference/system/xpackage/xpackage_members)\
[스트리밍 설치 및 Intelligent Delivery](/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [XPackageRegisterInstallationProgressChanged](/ko/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md)
- [XTaskQueueRegistrationToken](/ko/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)
- [XPackage](/ko/reference/system/xpackage/xpackage_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageInstallationProgressCallback](/ko/reference/system/xpackage/functions/xpackageinstallationprogresscallback.md)
