Compartilhar via

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

  • Artigo

Converte um erro recebido status código para a mensagem legível pelo usuário apropriada. A interface do usuário da credencial não chama esse método.

Sintaxe

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

Parâmetros

[in] ntsStatus

Tipo: NTSTATUS

O valor NTSTATUS que reflete o valor retornado da chamada do Winlogon para LsaLogonUser.

[in] ntsSubstatus

Tipo: NTSTATUS

O valor NTSTATUS que reflete o valor apontado pelo parâmetro SubStatus de LsaLogonUser quando essa função retorna após ser chamada pelo Winlogon.

[out] ppszOptionalStatusText

Tipo: LPWSTR*

Um ponteiro para a mensagem de erro que será exibida para o usuário. Pode ser NULL.

[out] pcpsiOptionalStatusIcon

Tipo: CREDENTIAL_PROVIDER_STATUS_ICON*

Um ponteiro para um ícone que será mostrado na credencial. Pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é necessário para a interface do usuário de logon.

Esse método é usado para relatar o resultado de uma tentativa de logon de volta para uma credencial. As informações em ntsStatus e ntsSubstatus também podem ser usadas quando os provedores de credenciais desejam gerar mensagens de erro personalizadas. Esse status texto dessa chamada será exibido na credencial selecionada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho credentialprovider.h