IConnectableCredentialProviderCredential::Connect method (credentialprovider.h)

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

[in] pqcws

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