Compartir a través de

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

  • Artículo

Convierte un código de estado de error recibido en el mensaje legible por el usuario adecuado. La interfaz de usuario de credenciales no llama a este método.

Sintaxis

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

Parámetros

[in] ntsStatus

Tipo: NTSTATUS

Valor NTSTATUS que refleja el valor devuelto de la llamada de Winlogon a LsaLogonUser.

[in] ntsSubstatus

Tipo: NTSTATUS

Valor NTSTATUS que refleja el valor al que apunta el parámetro SubStatus de LsaLogonUser cuando esa función vuelve después de llamar a Winlogon.

[out] ppszOptionalStatusText

Tipo: LPWSTR*

Puntero al mensaje de error que se mostrará al usuario. Puede ser NULL.

[out] pcpsiOptionalStatusIcon

Tipo: CREDENTIAL_PROVIDER_STATUS_ICON*

Puntero a un icono que se mostrará en la credencial. Puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método es necesario para la interfaz de usuario de inicio de sesión.

Este método se usa para notificar el resultado de un intento de inicio de sesión en una credencial. La información de ntsStatus y ntsSubstatus también se puede usar cuando los proveedores de credenciales desean generar mensajes de error personalizados. Ese texto de estado de esta llamada se mostrará en la credencial seleccionada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h