CompleteAsyncAuthentication Method of the IFWXAuthenticationCompletion Interface

The CompleteAsyncAuthentication method receives a notification that an asynchronous authentication operation that was initiated by a call to IFWXRadiusAuthenticator::AuthenticateRadiusUser has completed, and receives information associated with the authentication process.

Syntax

HRESULT CompleteAsyncAuthentication(
  [in]  BOOL fSuccess,
  [in]  DWORD Win32ErrorCode,
  [in]  IFWXAuthenticatedUser* pIFWXAuthenticatedUser,
  [in]  UserContextType UserData
);

Parameters

fSuccess

Boolean value that specifies whether the authentication operation completed successfully. If TRUE, the operation succeeded. If FALSE, it failed.

Win32ErrorCode

A Windows error code. This parameter is meaningful only when the fSuccess parameter is set to FALSE, in which case the error code provides the reason for the failure.

pIFWXAuthenticatedUser

Pointer to the IFWXAuthenticatedUser interface representing the user that was successfully authenticated.

UserData

The UserData parameter set in the call to the IFWXRadiusAuthenticator::AuthenticateRadiusUser method, for differentiation between completion notifications.

Return Value

Implementations of this method should handle any run-time error and return S_OK.

Requirements

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.

See Also

IFWXAuthenticationCompletion

Send comments about this topic to Microsoft

Build date: 11/30/2009