Contents Index Topic Contents | ||
Previous Topic: Methods Next Topic: IBindHost::CreateMoniker |
IAuthenticate::Authenticate
HRESULT Authenticate( [out] HWND *phwnd, [out] LPWSTR *pszUserName, [out] LPWSTR *pszPassword );Supplies authentication support to a URL moniker from a client application.
- Returns one of the following values:
S_OK Authentication was successful. E_ACCESSDENIED Authentication failed. E_INVALIDARG One or more of the parameters are invalid.
- phwnd
- Address of a client-provided HWND of the parent window for a default user interface. If no user interface is desired, the client must provide a username and password in the other parameters, and this handle is set to zero.
- pszUserName
- String that contains the username to use for authentication. If the client returns a value here, it should also set phwnd to zero.
- pszPassword
- String that contains the password to use for authentication. If the client returns a value here, it should also set phwnd to zero.
The default user interface is able to handle any authentication schemes recognized by the Win32 Internet API. Currently, the username and password options only handle the Basic authentication scheme.
This method is related to the InternetErrorDlg function in the Win32 Internet API. For more information about the Win32 Internet API, see Win32 Internet Functions Overview.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.