IWbemStatusCodeText::GetFacilityCodeText, méthode (wbemcli.h)
La méthode IWbemStatusCodeText::GetFacilityCodeText retourne le nom du sous-système où l’erreur s’est produite, par exemple « Windows », « WBEM », « SSPI » ou « RPC ».
Syntaxe
HRESULT GetFacilityCodeText(
[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 WMI_S_NO_ERROR si elle réussit.
Remarques
Pour permettre à la méthode GetFacilityCodeText de retourner le nom du sous-système, l’appelant doit libérer le pointeur dans le paramètre MessageText .
Exemples
L’exemple suivant décrit comment utiliser 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();
Configuration requise
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
Plateforme cible | Windows |
En-tête | wbemcli.h (include Wbemidl.h) |
Bibliothèque | Wbemuuid.lib |
DLL | Wmiutils.dll |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour