CStringT::FormatMessage
Met en forme une chaîne de message.
void __cdecl FormatMessage(
UINT nFormatID,
[, argument]...
);
void __cdecl FormatMessage(
PCXSTR pszFormat,
[, argument]...
);
Paramètres
nFormatID
L'identificateur de ressource de type chaîne qui contient le texte du message non mis en forme.pszFormat
Points à la chaîne de format.Elle est numérisée pour les insertions et par conséquent mise en forme.La chaîne de format est semblable aux chaînes de format de style d' printfde fonction runtime, à moins qu'elle tienne compte pour les paramètres sont insérés dans un ordre arbitraire.argument
Arguments facultatifs.
Notes
La fonction requiert une définition de message comme entrée.La définition de message est déterminée par pszFormat ou de la ressource de type chaîne reconnue par nFormatID.La fonction copie le texte du message mis en forme à l'objet d' CStringT , en traitant les séquences inclusif d'insertion si demandée.
[!REMARQUE]
Tente d'FormatMessage d'allouer la mémoire système pour la nouvelle chaîne mise en forme.Si la tentative échoue, une exception de mémoire est automatiquement levée.
Chaque insertion doit avoir un paramètre correspondant suivant le paramètre d' pszFormat ou d' nFormatID .Dans le texte du message, plusieurs séquences d'échappement sont prises en charge pour mettre en forme dynamiquement le message.Pour plus d'informations, consultez la fonction de FormatMessage windows dans Kit de développement logiciel Windows.
Exemple
// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str;
int nAsked = 5;
int nAgree = 4;
str.FormatMessage(_T("%1!d! of %2!d! writers agree: Soccer is %3%!"),
nAgree, nAsked, _T("Best"));
ASSERT(str == _T("4 of 5 writers agree: Soccer is Best!"));
Configuration requise
Header: cstringt.h