XPackageUnregisterPackageInstalled

Unregisters a previously registered package installed callback.

Syntax

bool XPackageUnregisterPackageInstalled(  
         XTaskQueueRegistrationToken token,  
         bool wait  
)

wait _In_
Type: bool

Indicates whether to block until any pending callbacks are completed.

Type: bool

If wait is false and unregistration is pending, returns false. Otherwise, returns true.

Note

This function isn't safe to call on a time-sensitive thread. For more information, see Time-sensitive threads.

Unregistration of a notification behaves as follows:

From the set of registered callbacks, unregistration removes the callback associated with the token.
If no callbacks are executing for that callback token, the call returns true.
If callbacks are executing and wait is true, the call will block until the executing callback has finished.
If callbacks are executing and wait is false, the call will not block but will return false. After the callback for the token is completed, the token is unregistered automatically.

This mechanism allows for the following coding patterns:

You can block on unregistration to ensure your callbacks are never invoked after a call to unregister.
You can choose not to block. To ensure that your callbacks are completed before deleting data, periodically call unregister with false for wait. When it finally returns true, all your callbacks are done and you can delete the state.
If your callback doesn't care whether it's being invoked during an unregister call, you can just pass false for wait and ignore the return value.

The following code sample illustrates the use of XPackageUnregisterPackageInstalled:

void StopListeningForDlc(XTaskQueueRegistrationToken token)
{
    XPackageUnregisterPackageInstalled(token, false);
}

Header: XPackage.h

Library: xgameruntime.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles