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();

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	wbemcli.h (包括 Wbemidl.h)
Library	Wbemuuid.lib
DLL	Wmiutils.dll