Share via

디버깅 및 오류 보고 전역 함수

  • 아티클

이러한 함수는 유용한 디버깅 및 추적 기능을 제공합니다.

이름 설명
AtlHresultFromLastError GetLastError HRESULT 형식의 오류 코드를 반환합니다.
AtlHresultFromWin32 Win32 오류 코드 HRESULT로 변환합니다.
AtlReportError 클라이언트에 오류 세부 정보를 제공하도록 설정합니다 IErrorInfo .
AtlThrow CAtlException를 throw합니다.
AtlThrowLastWin32 Windows 함수 GetLastError의 결과에 따라 오류를 표시하려면 이 함수를 호출합니다.

AtlHresultFromLastError

호출 스레드의 마지막 오류 코드 값을 HRESULT 형식으로 반환합니다.

HRESULT AtlHresultFromLastError();

설명

AtlHresultFromLastError 호출 GetLastError 하여 마지막 오류를 가져오고 HRESULT_FROM_WIN32 매크로를 사용하여 HRESULT로 변환한 후 오류를 반환합니다.

요구 사항

헤더: atlcomcli.h

AtlHresultFromWin32

Win32 오류 코드 HRESULT로 변환합니다.

AtlHresultFromWin32(DWORD error);

매개 변수

error
변환할 오류 값입니다.

설명

매크로 HRESULT_FROM_WIN32 사용하여 Win32 오류 코드를 HRESULT로 변환합니다.

참고 항목

사용하는 HRESULT_FROM_WIN32(GetLastError())대신 AtlHresultFromLastError 함수를 사용합니다.

요구 사항

헤더: atlcomcli.h

AtlReportError

개체의 IErrorInfo 클라이언트에 오류 정보를 제공하도록 인터페이스를 설정합니다.

HRESULT WINAPI AtlReportError(
    const CLSID& clsid,
    LPCOLESTR lpszDesc,
    const IID& iid = GUID_NULL,
    HRESULT hRes = 0);

HRESULT WINAPI AtlReportError(
    const CLSID& clsid,
    LPCOLESTR lpszDesc,
    DWORD dwHelpID,
    LPCOLESTR lpszHelpFile,
    const IID& iid = GUID_NULL,
    HRESULT hRes = 0);

HRESULT WINAPI AtlReportError(
    const CLSID& clsid,
    LPCSTR lpszDesc,
    const IID& iid = GUID_NULL,
    HRESULT hRes = 0);

HRESULT WINAPI AtlReportError(
    const CLSID& clsid,
    LPCSTR lpszDesc,
    DWORD dwHelpID,
    LPCSTR lpszHelpFile,
    const IID& iid = GUID_NULL,
    HRESULT hRes = 0);

HRESULT WINAPI AtlReportError(
    const CLSID& clsid,
    UINT nID,
    const IID& iid = GUID_NULL,
    HRESULT hRes = 0,
    HINSTANCE hInst = _AtlBaseModule.GetResourceInstance());

HRESULT WINAPI AtlReportError(
    const CLSID& clsid,
    UINT nID,
    DWORD dwHelpID,
    LPCOLESTR lpszHelpFile,
    const IID& iid = GUID_NULL,
    HRESULT hRes = 0,
    HINSTANCE hInst = _AtlBaseModule.GetResourceInstance());

매개 변수

clsid
[in] 오류를 보고하는 개체의 CLSID입니다.

lpszDesc
[in] 오류를 설명하는 문자열입니다. 유니코드 버전은 lpszDesc가 LPCOLESTR 형식임을 지정하고 ANSI 버전은 LPCSTR 형식을 지정합니다.

iid
[in] 오류를 정의하는 인터페이스의 IID이거나 운영 체제에서 오류를 정의한 경우 GUID_NULL.

hRes
[in] 호출자에게 반환하려는 HRESULT입니다.

nID
[in] 오류 설명 문자열이 저장되는 리소스 식별자입니다. 이 값은 0x0200 0xFFFF 사이에 있어야 합니다. 디버그 빌드에서 nID가 유효한 문자열을 인덱싱하지 않으면 ASSERT가 발생합니다. 릴리스 빌드에서 오류 설명 문자열은 "알 수 없는 오류"로 설정됩니다.

dwHelpID
[in] 오류에 대한 도움말 컨텍스트 식별자입니다.

lpszHelpFile
[in] 오류를 설명하는 도움말 파일의 경로와 이름입니다.

hInst
[in] 리소스에 대한 핸들입니다. 기본적으로 이 매개 변수는 __AtlBaseModuleModule::GetResourceInstance__AtlBaseModuleModule CAtlBaseModule의 전역 인스턴스 또는 CAtlBaseModule에서 파생된 클래스입니다.

Return Value

hRes 매개 변수가 0이 아니면 hRes 값을 반환합니다. hRes가 0이면 처음 네 버전의 AtlReportError 반환이 DISP_E_EXCEPTION. 마지막 두 버전은 매크로 MAKE_HRESULT(1, FACILITY_ITF,nID)의 결과를 반환합니다.

설명

lpszDesc 문자열은 오류에 대한 텍스트 설명으로 사용됩니다. 클라이언트가 반환AtlReportError하는 hRes를 받으면 클라이언트는 오류에 IErrorInfo 대한 세부 정보를 위해 구조에 액세스할 수 있습니다.

예시

STDMETHODIMP CMyControl::MyErrorProneMethod()
{
   BOOL bSucceeded = ErrorProneFunc();
   if (bSucceeded)
      return S_OK;
   else
      // hRes is set to DISP_E_EXCEPTION
      return AtlReportError(GetObjectCLSID(), L"My error message");
}

주의

C++ catch 처리기에서는 사용하지 AtlReportError 마세요. 이러한 함수의 일부 재정의는 내부적으로 ATL 문자열 변환 매크로를 사용하며, 이 매크로는 내부적으로 이 함수를 _alloca 사용합니다. C++ catch 처리기에서 사용하면 AtlReportError C++ catch 처리기에서 예외가 발생할 수 있습니다.

요구 사항

헤더: atlcom.h

AtlThrow

HRESULT 상태 코드를 기반으로 오류를 알리려면 이 함수를 호출합니다.

__declspec(noreturn) inline void AtlThrow(HRESULT hr);

매개 변수

Hr
표준 HRESULT 값입니다.

설명

이 함수는 오류 조건이 발생할 경우 ATL 및 MFC 코드에서 사용됩니다. 사용자 고유의 코드에서 호출할 수도 있습니다. 이 함수의 기본 구현은 기호 _ATL_NO_EXCEPTIONS 정의와 프로젝트 형식, MFC 또는 ATL에 따라 달라집니다.

모든 경우에 이 함수는 HRESULT를 디버거로 추적합니다.

Visual Studio 2015 업데이트 3 이상에서 이 함수는 가짜 SAL 경고를 방지하기 위해 __declspec(noreturn)에 기인합니다.

MFC 프로젝트에서 _ATL_NO_EXCEPTIONS 정의되지 않은 경우 이 함수는 HRESULT 값에 따라 CMemoryException 또는 COleException을 throw합니다.

_ATL_NO_EXCEPTIONS ATL 프로젝트에 정의되지 않은 경우 함수는 CAtlException을 throw합니다.

_ATL_NO_EXCEPTIONS 정의된 경우 함수는 예외를 throw하는 대신 어설션 실패를 발생합니다.

ATL 프로젝트의 경우 오류가 발생할 경우 ATL에서 사용할 이 함수의 고유한 구현을 제공할 수 있습니다. 이렇게 하려면 동일한 서명 AtlThrow 으로 고유한 함수를 정의하고 함수의 이름으로 #define AtlThrow . atlexcept.h를 포함하기 전에 이 작업을 수행해야 합니다.즉, atlbase.h에 atlexcept.h가 포함되어 있으므로 ATL 헤더를 포함하기 전에 수행해야 합니다. 가짜 SAL 경고를 방지하기 위해 함수 __declspec(noreturn) 의 특성을 지정합니다.

예시

// Constructors and operators cannot return error codes, and
// so they are the place where exceptions are generally used.
class CMyClass
{
private:
   CComPtr<IBuddy> m_spBuddy;
public:
   CMyClass()
   {
      HRESULT hr = m_spBuddy.CoCreateInstance(CLSID_Buddy);
      if (FAILED(hr))
         AtlThrow(hr);
   }
   //   methods ..
};

요구 사항

헤더: atldef.h

AtlThrowLastWin32

Windows 함수 GetLastError의 결과에 따라 오류를 표시하려면 이 함수를 호출합니다.

inline void AtlThrowLastWin32();

설명

이 함수는 디버거의 GetLastError 결과를 추적합니다.

MFC 프로젝트에서 _ATL_NO_EXCEPTIONS 정의되지 않은 경우 이 함수는 반환된 GetLastError값에 따라 CMemoryException 또는 COleException을 throw합니다.

_ATL_NO_EXCEPTIONS ATL 프로젝트에 정의되지 않은 경우 함수는 CAtlException을 throw합니다.

_ATL_NO_EXCEPTIONS 정의된 경우 함수는 예외를 throw하는 대신 어설션 실패를 발생합니다.

요구 사항

헤더: atldef.h

참고 항목

함수
디버깅 및 오류 보고 매크로