IConnectableCredentialProviderCredential::Connect method

Connects an IConnectableCredentialProviderCredential object. This method is called after the user clicks the Submit button within the Pre-Logon-Access Provider screen and before ICredentialProviderCredential::GetSerialization is called.

Syntax


HRESULT Connect(
  [in] IQueryContinueWithStatus *pqcws
);

Parameters

pqcws [in]

Type: IQueryContinueWithStatus*

A pointer to an IQueryContinueWithStatus object.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When Logon UI calls this method, it passes a pointer to an IQueryContinueWithStatus instance. This object is used to query if the credential provider should continue attempt to connect to the network and to display status messages to the user while attempting to connect. Robust credential providers should periodically call QueryContinue during attempts to connect to a network to be able to respond to user input.

After a successful call to Connect, the Logon UI displays a Disconnect button to the user. If the user clicks Disconnect, the Logon UI calls Disconnect on every credential provider that implements IConnectableCredentialProviderCredential.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Credentialprovider.h

IDL

Credentialprovider.idl

 

 

Show: