Metodo ICredentialProviderCredential::ReportResult (credentialprovider.h)

Articolo
02/26/2024

Converte un codice di stato di errore ricevuto nel messaggio leggibile utente appropriato. L'interfaccia utente delle credenziali non chiama questo metodo.

Sintassi

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

Parametri

[in] ntsStatus

Tipo: NTSTATUS

Valore NTSTATUS che riflette il valore restituito della chiamata Winlogon a LsaLogonUser.

[in] ntsSubstatus

Tipo: NTSTATUS

Valore NTSTATUS che riflette il valore puntato dal parametro SubStatus di LsaLogonUser quando tale funzione viene restituita dopo essere chiamata da Winlogon.

[out] ppszOptionalStatusText

Tipo: LPWSTR*

Puntatore al messaggio di errore che verrà visualizzato all'utente. Può essere NULL.

[out] pcpsiOptionalStatusIcon

Tipo: CREDENTIAL_PROVIDER_STATUS_ICON*

Puntatore a un'icona che verrà visualizzata nelle credenziali. Può essere NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo è necessario per l'interfaccia utente di accesso.

Questo metodo viene usato per segnalare il risultato di un tentativo di accesso a una credenziale. Le informazioni in ntsStatus e ntsSubstatus possono essere usate anche quando i provider di credenziali vogliono generare messaggi di errore personalizzati. Il testo di stato di questa chiamata verrà visualizzato nella credenziale selezionata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	credentialprovider.h

Condividi tramite