INSSUserAuthentication::Authenticate

Called when the client has authentication data to pass to the user authentication object.

Syntax

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

Parameters

[in] cbBlob

Specifies the size, in bytes, of the authentication data being passed from the client.

[in] pBlob

Specifies a pointer to the authentication data being passed from the client.

[in] pCommandContext.

Specifies a pointer to the command context that contains request context.

[in] Callback

Specifies a pointer to the callback method to be used 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 must 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,
      INSSCommandContext *pCommandContext,
      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 );
}

Previous

Next