IWbemStatusCodeText ::GetErrorCodeText, méthode (wbemcli.h)

Article
03/03/2024

La méthode IWbemStatusCodeText ::GetErrorCodeText retourne la description de chaîne de texte associée au code d’erreur.

Syntaxe

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

Paramètres

[in] hRes

Gérez le code d’erreur pour lequel vous souhaitez obtenir une description.

[in] LocaleId

Réservé. Ce paramètre doit être égal à 0 (zéro).

[in] lFlags

Réservé. Ce paramètre doit être égal à 0 (zéro).

[out] MessageText

Pointeur vers une chaîne contenant le texte descriptif du code d’erreur.

Valeur retournée

Cette méthode retourne WBEM_S_NO_ERROR si elle réussit.

Remarques

Pour permettre à GetErrorCodeText de renvoyer la description de la chaîne de texte, l’appelant doit libérer le pointeur dans le paramètre MessageText .

Exemples

L’exemple suivant décrit comment implémenter 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();

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (inclure Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Wmiutils.dll

Partager via