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.

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

Vea también

Referencia

CStringT Class

CStringT::FormatMessageV