Passer au contenu principal

XtfGetAumid

Obtient l’ID de modèle utilisateur d’application (AUMID) à l’index spécifié à partir d’un objet d’information sur un paquet.

Syntaxe

Paramètres

packageInfo
Type : XtfPackageInfo
[in] Le pointeur vers l’objet d’information d’un paquet. aumidIndex
Type : UINT32
[in] Index de l’AUMID dans le paquet. aumid
Type : PWSTR
[out, optional] L’AUMID du paquet à l’index spécifié dans aumidIndex. aumidBufferLength
Type : UINT32 *
[in, out] La longueur, en WCHAR, allouée pour aumid.

Valeur de retour

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 à l’index spécifié dans aumidIndex à partir de l’objet d’information d’un paquet inscrit. Un pointeur vers un objet d’information sur un paquet est retourné lorsque vous appelez la fonction XtfRegisterPackage ou XtfRegisterNetworkSharePackage pour inscrire un paquet. Avant d’appeler cette fonction, utilisez la fonction XtfGetcountofAppUserModelIds pour obtenir le nombre d’AUMID du paquet. Si vous spécifiez dans aumidIndex une valeur égale ou supérieure à 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 pour récupérer le nom complet d’un paquet inscrit. Pour plus d’informations sur les paquets, consultez Empaquetage.

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)
XtfRegisterPackage
XtfRegisterNetworkSharePackage
API Xtf supplémentaires
Dernière modification le 6 octobre 2026