Méthode ICredentialProviderCredential ::ReportResult (credentialprovider.h)

Article
02/24/2024

Convertit une erreur reçue status code dans le message lisible par l’utilisateur approprié. L’interface utilisateur des informations d’identification n’appelle pas cette méthode.

Syntaxe

HRESULT ReportResult(
  [in]  NTSTATUS                        ntsStatus,
  [in]  NTSTATUS                        ntsSubstatus,
  [out] LPWSTR                          *ppszOptionalStatusText,
  [out] CREDENTIAL_PROVIDER_STATUS_ICON *pcpsiOptionalStatusIcon
);

Paramètres

[in] ntsStatus

Type : NTSTATUS

Valeur NTSTATUS qui reflète la valeur de retour de l’appel Winlogon à LsaLogonUser.

[in] ntsSubstatus

Type : NTSTATUS

Valeur NTSTATUS qui reflète la valeur pointée par le paramètre SubStatus de LsaLogonUser lorsque cette fonction retourne après avoir été appelée par Winlogon.

[out] ppszOptionalStatusText

Type : LPWSTR*

Pointeur vers le message d’erreur qui sera affiché à l’utilisateur. Peut être NULL.

[out] pcpsiOptionalStatusIcon

Type : CREDENTIAL_PROVIDER_STATUS_ICON*

Pointeur vers une icône qui s’affiche sur les informations d’identification. Peut être NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode est requise pour l’interface utilisateur d’ouverture de session.

Cette méthode est utilisée pour signaler le résultat d’une tentative d’ouverture de session à des informations d’identification. Les informations contenues dans ntsStatus et ntsSubstatus peuvent également être utilisées lorsque les fournisseurs d’informations d’identification souhaitent générer des messages d’erreur personnalisés. Ce texte status de cet appel s’affiche sur les informations d’identification sélectionnées.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	credentialprovider.h

Partager via