INSSAuthenticationCallback::OnAuthenticateComplete

The INSSAuthenticationCallback::OnAuthenticateComplete method is used to inform the server of the results of the authentication process.

Syntax

HRESULT OnAuthenticateComplete (
NS_AUTH_RESULT Result,
INSSUserAuthentication *pUserAuthentication,
DWORD dwRequestId
);

Parameters

[in] Result

Specifies the results of the authentication. Values supported for this parameter include:

Value	Description
NS_AUTH_SUCCESS	Informs the server that access rights have been granted to the client.
NS_AUTH_DENIED	Informs the server that access rights have been denied to the client.
NS_AUTH_CONTINUE	Informs the server that the authentication process is not complete and to request another blob of data.
NS_AUTH_ERROR	Informs the server that an error occurred during the authentication process.

[in] pUserAuthentication

Specifies a pointer to the client’s user-authentication object.

[in] dwRequestId

Specifies a unique identifier of the instance of the client connection. The request ID is passed to the INSSUserAuthentication::Authenticate method.

Return Values

This method should always return S_OK.

Remarks

If the result passed in to this method is NS_AUTH_CONTINUE, the server calls the INSSUserAuthentication::GetChallenge method to send additional data from the authenticator back to the client.