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

LsaLogonUser에 대한 Winlogon 호출의 반환 값을 반영하는 NTSTATUS 값입니다.

[in] ntsSubstatus

형식: NTSTATUS

Winlogon에서 호출한 후 해당 함수가 반환될 때 LsaLogonUser의 SubStatus 매개 변수가 가리키는 값을 반영하는 NTSTATUS 값입니다.

[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