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.