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