다음을 통해 공유

TAPIERROR_FORMATMESSAGE 매크로(tapi.h)

  • 아티클

TAPIERROR_FORMATMESSAGE 매크로는 FormatMessage 함수에서 사용할 수 있는 표준 TAPI 오류 코드에 대한 식별자를 생성합니다.

구문

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

매개 변수

__ErrCode__

반환 값

없음

설명

이 메커니즘은 애플리케이션에 정의된 복구 방법(즉, 예기치 않은 오류 또는 내부 오류)이 없는 오류에 대한 정보를 표시하는 데만 사용해야 합니다. 대부분의 경우(다음 간소화된 예제와 달리) 처리되지 않은 오류의 결과로 애플리케이션이 수행하거나 사용자가 수행해야 하는 작업을 사용자에게 알리는 추가 텍스트를 포함하는 것이 좋습니다.

애플리케이션이 TAPI 함수에서 오류 결과를 가져오는 경우 오류 값을 TAPIERROR_FORMATMESSAGE 매크로에 전달할 수 있습니다. 그러면 FormatMessage에 전달할 메시지 식별자가 생성됩니다.

예제

다음 예제에서는 FormatMessage 를 사용하여 TAPI 오류 코드에 해당하는 오류 문자열을 생성합니다.

lResult = lineClose(hLine);

if (lResult < 0)
{
    FormatMessage(FORMAT_MESSAGE_FROM_HMODULE,
                  (LPCVOID)GetModuleHandle("TAPIUI.DLL"),
                  TAPIERROR_FORMATMESSAGE(lResult),
                  0,
                  (LPTSTR)pBuf,
                  BUFSIZE,
                  NULL);
    MessageBox(hWnd,pBuf,"TAPI ERROR",MB_OK);
}

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi.h