ICredentialProviderCredential：：ReportResult 方法 (credentialprovider.h)

将收到的错误状态代码转换为相应的用户可读消息。 凭据 UI 不调用此方法。

语法

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

参数

[in] ntsStatus

类型： NTSTATUS

NTSTATUS 值，该值反映对 LsaLogonUser 的 Winlogon 调用的返回值。

[in] ntsSubstatus

类型： NTSTATUS

NTSTATUS 值，该值反映 Winlogon 调用 WinlogonUser 后该函数返回时 LsaLogonUs 的 SubStatus 参数所指向的值。

[out] ppszOptionalStatusText

类型： LPWSTR*

指向将向用户显示的错误消息的指针。 可能为 NULL。

[out] pcpsiOptionalStatusIcon

类型： CREDENTIAL_PROVIDER_STATUS_ICON*

指向凭据上显示的图标的指针。 可能为 NULL。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

登录 UI 需要此方法。

此方法用于将登录尝试的结果报告回凭据。 当凭据提供程序想要生成自定义错误消息时，也可以使用 ntsStatus 和 ntsSubstatus 中的信息。 此调用中的状态文本将显示在所选凭据上。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	credentialprovider.h