CStringT::FormatMessage
Formatiert eine Meldungszeichenfolge.
void __cdecl FormatMessage(
UINT nFormatID,
[, argument]...
);
void __cdecl FormatMessage(
PCXSTR pszFormat,
[, argument]...
);
Parameter
nFormatID
Der Zeichenfolgenressourcenbezeichner, der den Text der Meldung unformatierten enthält.pszFormat
Zeigt auf die Formatsteuerzeichenfolge. Sie wird für Einfügungen überprüft und formatiert entsprechend. Die Formatzeichenfolge ist mit den Laufzeitfunktions-printf-Formatzeichenfolgen vergleichbar, außer sie die zulässt in einer beliebigen Reihenfolge eingefügt werden Parameter.argument
Optionale Argumente.
Hinweise
Die Funktion erfordert eine Meldungsdefinition als Eingabe. Die Meldungsdefinition wird durch pszFormat oder von der Zeichenfolgenressource bestimmt, die von nFormatID identifiziert wird. Die Funktion kopiert den formatierten Meldungstext zum CStringT-Objekt und verarbeitet alle eingebetteten Einfügungssequenzen, wenn sie aufgerufen wird.
Hinweis
FormatMessage versucht, Systemspeicher für die neu formatierten Zeichenfolge zuzuordnen.Wenn dieser Versuch fehlschlägt, wird eine Arbeitsspeicherausnahme automatisch ausgelöst.
Jede Einfügung muss einen entsprechenden Parameter, der dem pszFormat oder nFormatID-Parameter folgt. Innerhalb des Meldungstexts werden mehrere Escapesequenzen für die Meldung dynamisch formatieren unterstützt. Weitere Informationen finden Sie die Funktion Windows FormatMessage in Windows SDK.
Beispiel
// 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!"));
Anforderungen
Header: cstringt.h