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)
程式庫	Wbemuuid.lib
Dll	Wmiutils.dll