Sdílet prostřednictvím


CStringT::FormatMessage

Zformátuje řetězec zprávy.

void __cdecl FormatMessage(
   UINT nFormatID,
   [, argument]...
);
void __cdecl FormatMessage(
   PCXSTR pszFormat,
   [, argument]...
);

Parametry

  • nFormatID
    Identifikátor prostředku řetězec obsahující zprávu neformátovaný text.

  • pszFormat
    Řetězec formátu ovládací body.Budou vyhledány vloží a odpovídajícím způsobem formátovány.Formátovací řetězec je podobná funkci run-time printf -styl řetězce formátu, s výjimkou umožňuje vložit do libovolného pořadí parametrů.

  • argument
    Volitelné argumenty.

Poznámky

Funkce vyžaduje definici zprávu jako vstup.Definice zpráv stanoví podle pszFormat nebo z řetězce prostředek identifikovaný nFormatID .Tato funkce zkopíruje text formátované zprávy CStringT Pokud požadované vložte objekt zpracování žádné vložené sekvence.

[!POZNÁMKA]

FormatMessagePokus o přidělení paměti systému pro nově formátovaný řetězec.Pokud se to nezdaří, je automaticky vyvolána výjimka paměti.

Každé vložení, musí mít odpovídající parametr následující pszFormat nebo nFormatID parametr.V textu zprávy jsou podporovány několik sekvence escape pro dynamicky formátování zprávy.Další informace naleznete v tématu Windows FormatMessage funkce .

Příklad

// 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!"));   

Požadavky

Záhlaví: cstringt.h

Viz také

Referenční dokumentace

Třída CStringT

CStringT::FormatMessageV