Метод 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
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Wmiutils.dll