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

# XPackageRegisterPackageInstalled

> XPackageRegisterPackageInstalled

# XPackageRegisterPackageInstalled

Inscrit un rappel à appeler lorsqu'une installation est terminée.

## Syntaxe

```cpp theme={null}
HRESULT XPackageRegisterPackageInstalled(  
         XTaskQueueHandle queue,  
         void* context,  
         XPackageInstalledCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### Paramètres

*queue*   \_In\_\
Type : XTaskQueueHandle

File d'attente asynchrone sur laquelle le rappel doit s'exécuter.

*context*   \_In\_opt\_\
Type : void\*

Contexte à passer au rappel.

*callback*   \_In\_\
Type : XPackageInstalledCallback\*

Rappel défini par l'utilisateur à appeler lorsqu'une installation est terminée.

*token*   \_Out\_\
Type : [XTaskQueueRegistrationToken\*](/fr-CA/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

Au retour, contient un jeton qui identifie le rappel et qui peut servir à annuler l'inscription du rappel avec [XPackageUnregisterPackageInstalled](/fr-CA/reference/system/xpackage/functions/xpackageunregisterpackageinstalled).

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Les notifications PackageInstalled permettent de déterminer quand un nouveau package est entièrement installé.

Les API [XPackageEnumeratePackages](/fr-CA/reference/system/xpackage/functions/xpackageenumeratepackages) et [XPackageRegisterPackageInstalled](/fr-CA/reference/system/xpackage/functions/xpackageregisterpackageinstalled) fournissent toutes deux des détails sur une installation au moyen d'une structure **XPackageDetails**. Si le package est en cours d'installation, la propriété **installing** a la valeur true et vous pouvez créer un moniteur d'installation afin d'utiliser l'identificateur du package pour surveiller la progression de l'installation.

Il n'existe aucune notification générique de file d'attente d'installation; l'objectif est d'utiliser [XPackageEnumeratePackages](/fr-CA/reference/system/xpackage/functions/xpackageenumeratepackages) pour afficher et suivre les éléments en cours, et d'utiliser **PackageInstalled** pour annoncer la présence d'un nouveau DLC. Il n'existe pas non plus d'API pour arrêter, démarrer ou annuler une installation. Du point de vue d'un jeu, l'installation doit se gérer elle-même. Les erreurs font automatiquement l'objet de nouvelles tentatives et sont invisibles pour le jeu.

Dans l'exemple suivant, **XPackageRegisterPackageInstalled** est utilisé pour afficher un message lorsqu'un nouveau package de DLC est installé :

```cpp theme={null}
void CALLBACK NewPackageAdded(void* /* context */, const XPackageDetails* details)
{
    if (details->kind == XPackageKind::Content)
    {
        printf("Package added: %s\n", details->displayName);
    }
}

HRESULT ListenForNewDlc(XTaskQueueHandle queue, XTaskQueueRegistrationToken* token)
{
    HRESULT hr = XPackageRegisterPackageInstalled(queue, nullptr, NewPackageAdded, token);
    return hr;
}

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

## Configuration requise

**En-tête :** XPackage.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Installation en continu : état](/fr-CA/build/core-features/common/packaging/packaging-installstatus)

## Voir aussi

[XPackage](/fr-CA/reference/system/xpackage/xpackage_members)


## Related topics

- [XPackageRegisterPackageInstalled](/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XPackageUnregisterPackageInstalled](/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md)
- [XPackageInstalledCallback](/reference/system/xpackage/functions/xpackageinstalledcallback.md)
- [XPackageEnumerationCallback](/reference/system/xpackage/functions/xpackageenumerationcallback.md)
- [XPackage](/reference/system/xpackage/xpackage_members.md)