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 );
}
See Also
INSSUserAuthentication::GetChallenge, INSSAuthenticationCallback::OnAuthenticateComplete
© 1996-1998 Microsoft Corporation. All rights reserved.