CStringT::FormatMessage
Da formato a una cadena de mensaje.
void __cdecl FormatMessage(
UINT nFormatID,
[, argument]...
);
void __cdecl FormatMessage(
PCXSTR pszFormat,
[, argument]...
);
Parámetros
nFormatID
El identificador de recurso de cadena que contiene el texto del mensaje sin formato.pszFormat
Apunta a la cadena de la formato-CONTROL.Se analiza para insertar y con formato en consecuencia.La cadena de formato es similar a la función printf- cadenas en tiempo de ejecución del formato de estilo, a menos que permite que los parámetros sean insertados en un orden arbitrario.argument
argumentos opcionales.
Comentarios
La función requiere una definición de mensaje como entrada.La definición del mensaje viene determinada por pszFormat o de recursos de cadena identificado por nFormatID.La función copia el texto del mensaje con formato al objeto de CStringT , procesando cualquier secuencia incrustada de inserción si se solicita.
[!NOTA]
FormatMessage intenta asignar memoria del sistema para la cadena de formato.Si se produce este intento, una excepción automáticamente de la memoria se produce.
Cada inserción debe tener un parámetro correspondiente que sigue al parámetro de pszFormat o de nFormatID .Dentro del texto del mensaje, varias secuencias de escape se admiten para dinámicamente dar formato al mensaje.Para obtener más información, vea la función de Windows FormatMessage en Windows SDK.
Ejemplo
// 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!"));
Requisitos
encabezado: cstringt.h