다음을 통해 공유


CStringT::FormatMessage

메시지 문자열의 형식을 지정 합니다.

void __cdecl FormatMessage(
   UINT nFormatID,
   [, argument]...
);
void __cdecl FormatMessage(
   PCXSTR pszFormat,
   [, argument]...
);

매개 변수

  • nFormatID
    포맷 되지 않은 메시지 텍스트가 포함 된 문자열 리소스 식별자입니다.

  • pszFormat
    컨트롤 서식 문자열을 가리킵니다.삽입에 대 한 검색 고 그에 따라 서식이 지정 됩니다.형식 문자열은 런타임 함수에 유사 printf-스타일 형식 문자열을 제외 하 고 매개 변수는 임의의 순서로 삽입할 수 있습니다.

  • argument
    선택적 인수입니다.

설명

함수는 입력 메시지 정의 해야합니다.메시지 정의 의해 결정 됩니다 pszFormat 또는 식별 하는 문자열 리소스에서 nFormatID.서식이 지정 된 메시지 텍스트를 복사 하는 함수는 CStringT 개체를 포함 하는 처리를 요청 하는 경우 시퀀스 삽입.

[!참고]

FormatMessage새로 서식이 지정 된 문자열에 대 한 시스템 메모리를 할당 하려고 시도 합니다.이 시도가 실패 하면 메모리 예외는 자동으로 throw 됩니다.

각 삽입 해당 매개 변수 다음에 있어야 합니다의 pszFormat 또는 nFormatID 매개 변수.메시지 텍스트 내에서 몇 가지 이스케이프 시퀀스 메시지 서식을 동적으로 지원 됩니다.자세한 내용은 Windows FormatMessage 기능에 Windows SDK.

예제

// 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!"));   

요구 사항

헤더: cstringt.h

참고 항목

참조

CStringT 클래스

CStringT::FormatMessageV