IWbemStatusCodeText::GetErrorCodeText 메서드(wbemcli.h)

IWbemStatusCodeText::GetErrorCodeText 메서드는 오류 코드와 연결된 텍스트 문자열 설명을 반환합니다.

구문

HRESULT GetErrorCodeText(
  [in]  HRESULT hRes,
  [in]  LCID    LocaleId,
  [in]  long    lFlags,
  [out] BSTR    *MessageText
);

매개 변수

[in] hRes

설명을 원하는 오류 코드에 대한 핸들입니다.

[in] LocaleId

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

[in] lFlags

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

[out] MessageText

오류 코드의 설명 텍스트를 포함하는 문자열에 대한 포인터입니다.

반환 값

이 메서드는 성공하면 WBEM_S_NO_ERROR 반환합니다.

설명

GetErrorCodeText가 텍스트 문자열 설명을 반환할 수 있도록 하려면 호출자가 MessageText 매개 변수의 포인터를 해제해야 합니다.

예제

다음 예제에서는 GetErrorCodeText를 구현하는 방법을 설명합니다.

IWbemStatusCodeText * pStatus = NULL;

    SCODE sc = CoCreateInstance(CLSID_WbemStatusCodeText,
                                0, 
                                CLSCTX_INPROC_SERVER,
                                IID_IWbemStatusCodeText,
                                (LPVOID *) &pStatus);
    
    if(sc == S_OK)
    {
        BSTR bstr = 0;

        // The m_hres isan HRESULT variable that has already
        // been declared and initialized.
        sc = pStatus->GetErrorCodeText(m_hres, 0, 0, &bstr);
        if(sc == S_OK)
        {
            // to do, display this:
            SysFreeString(bstr);
            bstr = 0;
        }
        sc = pStatus->GetFacilityCodeText(m_hres, 0, 0, &bstr);
        if(sc == S_OK)
        {
            // to do, display this:
            SysFreeString(bstr);
            bstr = 0;
        }
        pStatus->Release();
    }

    // clean up.
    pStatus->Release();

요구 사항