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 によって呼び出された後に関数が戻るときに LsaLogonUserSubStatus パラメーターが指す値を反映する NTSTATUS 値。

[out] ppszOptionalStatusText

種類: LPWSTR*

ユーザーに表示されるエラー メッセージへのポインター。 NULL を指定できます。

[out] pcpsiOptionalStatusIcon

種類: CREDENTIAL_PROVIDER_STATUS_ICON*

資格情報に表示されるアイコンへのポインター。 NULL を指定できます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、ログオン UI に必要です。

このメソッドは、ログオン試行の結果を資格情報に報告するために使用されます。 ntsStatusntsSubstatus の情報は、資格情報プロバイダーがカスタム エラー メッセージを生成する場合にも使用できます。 この呼び出しの状態テキストは、選択した資格情報に表示されます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー credentialprovider.h