IWbemStatusCodeText::GetFacilityCodeText メソッド (wbemcli.h)

IWbemStatusCodeText::GetFacilityCodeText メソッドは、エラーが発生したサブシステムの名前 ("Windows"、"WBEM"、"SSPI"、"RPC" など) を返します。

構文

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

パラメーター

[in] hRes

説明が必要なエラー コードを処理します。

[in] LocaleId

予約済み。 このパラメーターは 0 (ゼロ) である必要があります。

[in] lFlags

予約済み。 このパラメーターは 0 (ゼロ) である必要があります。

[out] MessageText

エラー コードの説明テキストを含む文字列へのポインター。

戻り値

成功した場合、このメソッドは WMI_S_NO_ERROR を返します。

解説

GetFacilityCodeText メソッドがサブシステム名を返せるようにするには、呼び出し元が MessageText パラメーター内のポインターを解放する必要があります。

例

次の例では、 GetFacilityCodeText の使用方法について説明します。

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 is an HRESULT variable that has already
        // been declared and initialized.
        sc = pStatus->GetErrorCodeText(m_hres, 0, 0, &bstr);
        if(sc == S_OK)
        {
            // ...display string here.
            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