Udostępnij za pośrednictwem


CStringT::FormatMessage

Formatuje ciąg wiadomości.

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

Parametry

  • nFormatID
    Identyfikator zasobu ciągu zawiera tekst niesformatowany komunikat.

  • pszFormat
    Wskazuje ciąg formatu formantu.Będzie on skanowany w poszukiwaniu wstawia i odpowiednio sformatowane.Ciąg formatu jest podobna do funkcji printf-styl ciągi formatów z wyjątkiem umożliwia parametrów w dowolnego zamówienia.

  • argument
    Opcjonalne argumenty.

Uwagi

Funkcja wymaga definicji wiadomości jako danych wejściowych.Definicja wiadomości jest ustalana przez pszFormat lub z zasobu ciągu określonego przez nFormatID.Funkcja kopiuje tekst sformatowany komunikat CStringT obiektu dowolnego osadzone przetwarzania Wstaw sekwencje żądanie.

[!UWAGA]

FormatMessagepróbuje przydzielić pamięci dla nowo sformatowanym ciągu.Jeśli ta próba nie powiedzie się, pamięci jest automatycznie wyjątek.

Wstaw każdy musi mieć odpowiedni parametr po pszFormat lub nFormatID parametru.W tekście wiadomości kilku sekwencji unikowych są obsługiwane dla dynamicznie formatowanie wiadomości.Aby uzyskać więcej informacji, zobacz Windows FormatMessage działać w Windows SDK.

Przykład

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

Wymagania

Nagłówek: cstringt.h

Zobacz też

Informacje

Klasa CStringT

CStringT::FormatMessageV