IAuthenticate::Authenticate

Called by the URL Moniker when it needs basic authentication information from a bind client.

HRESULT Authenticate(
  HWND *phwnd,         //Pointer to HWND
  LPWSTR *pszUserName, //Username for authentication.
  LPWSTR *pszPassword  //Password for authentication.
);
 

Parameters

phwnd

[out] Pointer to a client-provided HWND of the parent window for a default authentication 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 the value INVALID_HANDLE_VALUE.

pszUserName

[out] Client-provided username for authentication. If the client returns a value here, it should also set *phwnd = INVALID_HANDLE_VALUE.

pszPassword

[out] Client-provided password for authentication. If the client returns a value here, it should also set *phwnd = INVALID_HANDLE_VALUE.

Return Values

S_OK

The operation was successful.

E_INVALIDARG

One or more parameters are invalid.

Remarks

The client can return username and password strings, or it can provide an HWND that is used to present default authentication user interface.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.