CStringT::FormatMessage
Formata uma cadeia de caracteres da mensagem.
void __cdecl FormatMessage(
UINT nFormatID,
[, argument]...
);
void __cdecl FormatMessage(
PCXSTR pszFormat,
[, argument]...
);
Parâmetros
nFormatID
O identificador de recurso de seqüência de caracteres contém o texto não formatado.pszFormat
Aponta para a seqüência de caracteres de controle de formato.Ele será seja verificado em busca de inserções e formatado adequadamente.A seqüência de caracteres de formato é semelhante à função de time de execução printf-cadeias de caracteres de formato de estilo exceto permite os parâmetros a serem inseridos em uma ordem arbitrária.argument
Argumentos opcionais.
Comentários
A função requer uma definição de mensagem sistema autônomo entrada.A definição de mensagem é determinada por pszFormat ou da seqüência de caracteres do recurso identificado por nFormatID. A função copia o texto da mensagem formatado para o CStringT objeto, processando qualquer incorporado inserir seqüências se solicitado.
.gif "Observação") Observação: |
|---|
FormatMessage tenta alocar memória do sistema para a seqüência de caracteres recém-formatada. Se essa tentativa falhar, uma exceção de memória é lançada automaticamente. |
Cada inserção deve ter um parâmetro correspondente seguindo o pszFormat ou nFormatID parâmetro. Dentro do texto de mensagem, várias seqüências de escape têm suporte para formatação da mensagem dinamicamente.Para obter mais informações, consulte o Windows FormatMessage funcionar a Windows SDK.
Exemplo
// 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
Cabeçalho: cstringt.h