ICredentialProviderCredential::ReportResult-Methode (credentialprovider.h)

Artikel
02/24/2024

Übersetzt einen empfangenen Fehler status Code in die entsprechende vom Benutzer lesbare Nachricht. Die Benutzeroberfläche für Anmeldeinformationen ruft diese Methode nicht auf.

Syntax

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

Parameter

[in] ntsStatus

Typ: NTSTATUS

Der NTSTATUS-Wert , der den Rückgabewert des Winlogon-Aufrufs von LsaLogonUser darstellt.

[in] ntsSubstatus

Typ: NTSTATUS

Der NTSTATUS-Wert , der den Wert darstellt, auf den der SubStatus-Parameter von LsaLogonUser verweist, wenn diese Funktion nach dem Aufruf durch Winlogon zurückgegeben wird.

[out] ppszOptionalStatusText

Typ: LPWSTR*

Ein Zeiger auf die Fehlermeldung, die dem Benutzer angezeigt wird. Kann NULL sein.

[out] pcpsiOptionalStatusIcon

Typ: CREDENTIAL_PROVIDER_STATUS_ICON*

Ein Zeiger auf ein Symbol, das in den Anmeldeinformationen angezeigt wird. Kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ist für die Anmelde-Benutzeroberfläche erforderlich.

Diese Methode wird verwendet, um das Ergebnis eines Anmeldeversuchs an anmeldeinformationen zu melden. Die Informationen in ntsStatus und ntsSubstatus können auch verwendet werden, wenn Anmeldeinformationsanbieter benutzerdefinierte Fehlermeldungen generieren möchten. Dieser status Text aus diesem Aufruf wird in den ausgewählten Anmeldeinformationen angezeigt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	credentialprovider.h

Freigeben über