XtfGetErrorText
Obtient un message d’erreur convivial et un texte d’action utilisateur pour leHRESULT spécifié.
Syntaxe
Paramètres
HResultType : HRESULT [in]
HRESULT pour lequel rechercher le message d’erreur et le texte d’action utilisateur.
errorMessageBufferType : PWSTR* [out] Pointeur vers la mémoire tampon qui reçoit le message d’erreur sous forme de chaîne terminée par un caractère null. Pour déterminer la longueur de mémoire tampon requise, définissez ce paramètre sur
nullptr et le paramètre errorMessageBufferLength sur 0. Lors de l’appel, errorMessageBufferLength est défini sur la longueur de la mémoire tampon requise en WCHARs, caractère null de fin compris.
errorMessageBufferLengthType : UINT32* [in, out] En entrée, longueur de la mémoire tampon du message d’erreur en WCHARs. La longueur de la mémoire tampon doit inclure de la place pour un caractère null de fin. En sortie, longueur requise de errorMessageBuffer en WCHARs userActionTextBuffer
Type : PWSTR* [out] Pointeur vers la mémoire tampon qui reçoit le texte d’action utilisateur sous forme de chaîne terminée par un caractère null. Pour déterminer la longueur de mémoire tampon requise, définissez ce paramètre sur
nullptr et le paramètre userActionTextBufferLength sur 0. Lors de l’appel, userActionTextBufferLength est défini sur la longueur de la mémoire tampon requise en WCHARs, caractère null de fin compris.
userActionTextBufferLengthType : UINT32* [in, out] Longueur de la mémoire tampon du texte d’action utilisateur en WCHARs. La longueur de la mémoire tampon doit inclure de la place pour un caractère null de fin.
Valeur de retour
Type : HRESULT RetourneS_OK en cas de réussite ; sinon, retourne un code d’erreur HRESULT.
Si S_OK est retourné, la fonction a réussi. errorMessageBuffer et userActionTextBuffer sont respectivement définis sur le message d’erreur et le texte d’action utilisateur pour le HRESULT spécifié.
Si HRESULT_FROM_WIN32(ERROR_MORE_DATA) est retourné, la mémoire tampon fournie pour errorMessageBuffer ou userActionTextBuffer n’était pas assez grande. errorMessageBufferLength et userActionTextBufferLength sont respectivement définis sur les longueurs de mémoire tampon requises pour le message d’erreur et le texte d’action utilisateur du HRESULT spécifié.
Si un autre code HRESULT est retourné, une erreur inattendue s’est produite.
Remarques
Si leHRESULT passé à XtfGetErrorText n’est pas un code d’erreur XBOX Tools Framework (XTF) reconnu, errorMessageBuffer est défini sur “Unspecified error”. Vous pouvez utiliser ce résultat pour vérifier si le HRESULT spécifié est un code d’erreur XTF reconnu. Pour plus d’informations sur les codes d’erreur XTF reconnus, consultez Erreurs de transport XTF (rubrique sous NDA).
Configuration requise
En-tête : xtfapi.h Bibliothèque : XtfApi.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)Voir aussi
XtfConsoleControlRéférence de l’API native XBOX Tools Framework