IHttpSecurity::OnSecurityProblem method

Notifies the client application about an authentication problem.

Syntax

HRESULT OnSecurityProblem(
  [in] DWORD dwProblem
);

Parameters

dwProblem [in]

An unsigned long integer value that contains the authentication problem encountered. This can be one of the following values defined in the WinInet Error Messages.

ERROR_INTERNET_SEC_CERT_DATE_INVALID

ERROR_INTERNET_SEC_CERT_CN_INVALID

ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR

ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR

ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION

ERROR_INTERNET_INVALID_CA

ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED

Return value

Returns one of the following values.

Return code Description
RPC_E_RETRY

The calling application should continue or retry the download.

S_FALSE

The calling application should open a dialog box to warn the user.

E_ABORT

The calling application should abort the download.

 

Remarks

Security Warning: Incorrect implementation of this method can compromise the security of your application. By returning a value of RPC_E_RETRY, users of your application might be exposed to unwanted information disclosure. RPC_E_RETRY should be returned only when the application is running on a known trusted server or after you have verified information from the user. For more information, refer to Security Considerations: URL Monikers.

The IHttpSecurity interface should be implemented by applications that handle any authentication problems, instead of using the default user interface.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Product

Internet Explorer 4.0

See also

IHttpSecurity