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

# XtfGetAumid

> XtfGetAumid

# XtfGetAumid

Obtient l'ID de modèle utilisateur d'application (AUMID) à l'index spécifié à partir d'un objet d'informations sur le package.

## Syntaxe

```cpp theme={null}
HRESULT XtfGetAumid(
         XtfPackageInfo packageInfo,
         UINT32 aumidIndex,
         PWSTR aumid,
         UINT32 *aumidBufferLength
)  
```

### Paramètres

*packageInfo*\
Type : XtfPackageInfo

\[in] Pointeur vers l'objet d'informations d'un package.

*aumidIndex*\
Type : UINT32

\[in] Index de l'AUMID dans le package.

*aumid*\
Type : PWSTR

\[out, optional] AUMID situé à l'index spécifié dans `aumidIndex` pour le package.

*aumidBufferLength*\
Type : UINT32 \*

\[in, out] Longueur, en **WCHAR**, allouée pour `aumid`.

### Valeur renvoyée

Type : HRESULT

Retourne `S_OK` en cas de réussite. Si `aumid` n'est pas assez grand, cette fonction retourne `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` et la longueur de mémoire tampon requise est retournée dans `aumidBufferLength`.

## Remarques

Utilisez cette fonction pour obtenir l'AUMID situé à l'index spécifié dans `aumidIndex` à partir de l'objet d'informations d'un package inscrit. Un pointeur vers un objet d'informations sur le package est retourné lors de l'appel de la fonction [XtfRegisterPackage](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md) ou [XtfRegisterNetworkSharePackage](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md) pour inscrire un package.

Avant d'appeler cette fonction, utilisez la fonction [XtfGetcountofAppUserModelIds](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) pour obtenir le nombre d'AUMID du package. Si vous spécifiez dans `aumidIndex` une valeur supérieure ou égale à la valeur retournée par `XtfGetcountofAppUserModelIds`, une erreur se produit. De même, une erreur se produit s'il n'y a aucune donnée à récupérer à l'index spécifié dans `aumidIndex`.

Vous pouvez également utiliser la fonction [XtfGetPackageFullName](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md) pour récupérer le nom complet d'un package inscrit. Pour plus d'informations sur les packages, consultez [Empaquetage](https://docs.xbox.com/fr/build/core-features/common/packaging/gc-packaging-toc.md).

## Configuration requise

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

**Bibliothèque :** XtfApi.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

[Erreurs de transport XTF (rubrique sous NDA)](https://docs.xbox.com/fr/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[XtfRegisterPackage](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)\
[XtfRegisterNetworkSharePackage](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)\
[API Xtf supplémentaires](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetTitleOSState](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetCountofAppUserModelIds](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)
- [XtfGetPackageFullName](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackageOnDrive](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfregisterpackageondrive-xtfapi-xbox-windows-m.md)