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

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

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

<a id="retvalSection" />

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

<a id="remarksSection" />

## 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](/fr/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m) ou [XtfRegisterNetworkSharePackage](/fr/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m) pour inscrire un package.

Avant d'appeler cette fonction, utilisez la fonction [XtfGetcountofAppUserModelIds](/fr/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m) 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](/fr/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m) pour récupérer le nom complet d'un package inscrit. Pour plus d'informations sur les packages, consultez [Empaquetage](/fr/build/core-features/common/packaging/gc-packaging-toc).

<a id="requirements" />

## Configuration requise

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

**Bibliothèque :** XtfApi.lib

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

<a id="seealsoSection" />

## Voir aussi

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


## Related topics

- [XtfGetAumid](/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSState](/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)