Método IWbemStatusCodeText::GetFacilityCodeText (wbemcli.h)

El método IWbemStatusCodeText::GetFacilityCodeText devuelve el nombre del subsistema donde se produjo el error, como "Windows", "WBEM", "SSPI" o "RPC".

Sintaxis

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

Parámetros

[in] hRes

Controle el código de error para el que desea una descripción.

[in] LocaleId

Reservado. Este parámetro debe ser 0 (cero).

[in] lFlags

Reservado. Este parámetro debe ser 0 (cero).

[out] MessageText

Puntero a una cadena que contiene el texto descriptivo del código de error.

Valor devuelto

Este método devuelve WMI_S_NO_ERROR si se ejecuta correctamente.

Comentarios

Para permitir que el método GetFacilityCodeText devuelva el nombre del subsistema, el llamador debe liberar el puntero en el parámetro MessageText .

Ejemplos

En el ejemplo siguiente se describe cómo usar 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();

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Wmiutils.dll