IWbemStatusCodeText::GetFacilityCodeText-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemStatusCodeText::GetFacilityCodeText-Methode gibt den Namen des Subsystems zurück, in dem der Fehler aufgetreten ist, z. B. "Windows", "WBEM", "SSPI" oder "RPC".

Syntax

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

Parameter

[in] hRes

Behandeln Sie den Fehlercode, für den Sie eine Beschreibung benötigen.

[in] LocaleId

Reserviert. Dieser Parameter muss 0 (null) sein.

[in] lFlags

Reserviert. Dieser Parameter muss 0 (null) sein.

[out] MessageText

Zeiger auf eine Zeichenfolge, die den beschreibenden Text des Fehlercodes enthält.

Rückgabewert

Diese Methode gibt bei erfolgreicher Ausführung WMI_S_NO_ERROR zurück.

Hinweise

Damit die GetFacilityCodeText-Methode den Subsystemnamen zurückgibt, muss der Aufrufer den Zeiger im MessageText-Parameter freigeben.

Beispiele

Im folgenden Beispiel wird die Verwendung von GetFacilityCodeText beschrieben.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Wmiutils.dll

Share via