CStringT::FormatMessage
Formatta una stringa di messaggio.
void __cdecl FormatMessage(
UINT nFormatID,
[, argument]...
);
void __cdecl FormatMessage(
PCXSTR pszFormat,
[, argument]...
);
Parametri
nFormatID
L'identificatore della risorsa di tipo stringa contenente il testo del messaggio non formattato.pszFormat
Punta alla stringa di formato controllo.Verrà a scansione dei comandi e verrà formattata di conseguenza.La stringa di formato è simile alle stringhe di formato stile printfdi funzione in fase di esecuzione, a meno che non consentire che i parametri da inserire in un ordine arbitrario.argument
Argomenti facoltativi.
Note
La funzione richiede una definizione del messaggio come input.La definizione del messaggio è determinata da pszFormat o a partire dalla risorsa di tipo stringa identificata da nFormatID.La funzione copia il testo del messaggio formattato all'oggetto CStringT, elaborando tutte le sequenze incorporate di inserimento se richiesta.
[!NOTA]
FormatMessage tenta di allocare la memoria di sistema per la stringa così formattata.Se tale autenticazione non riesce, viene generata un'eccezione di memoria viene generata automaticamente.
Ogni inserimento deve avere un parametro corrispondente che segue il parametro nFormatID o pszFormat.Nel testo del messaggio, varie sequenze di escape supportate in modo dinamico per formattare il messaggio.Per ulteriori informazioni, vedere la funzione di Windows FormatMessage in Windows SDK.
Esempio
// 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!"));
Requisiti
Header: cstringt.h