INSSUserAuthentication::Authenticate

The INSSUserAuthentication::Authenticate method is called when the client has authentication data to pass to the user authentication object.

Syntax

HRESULT Authenticate (
DWORD cbBlob,
BYTE *pBlob,
INSSAuthenticationCallback *pCallback,
DWORD dwRequestId
);

Parameters

[in] cbBlob

Specifies the size in bytes of the authentication data from the client.

[in] pBlob

Specifies a pointer to the authentication data from the client.

[in] Callback

Specifies a pointer to the callback method to call with the results

[in] dwRequestId

Specifies a DWORD specifying the request ID. The request ID is passed to the callback to uniquely identify this request.

Return Values

This method should always return S_Ok upon successful completion.

Remarks

The following sample code demonstrates a skeletal implementation of this method:

HRESULT CUserAuthentication::Authenticate(
      DWORD cbBlob,
      BYTE *pBlob,
      INSSAuthenticationCallback *pCallback,
      DWORD dwRequestId )
{
  NS_AUTH_RESULT Result;
  //
  // Do the user authentication here.
  //
  //
  // Callback with the results.
  //
  pCallback->OnAuthenticateComplete( 
          Result,
          ( INSSUserAuthentication * )this,
          dwRequestId );
  return( hr );
}