INSSUserAuthentication::GetAuthenticator

The INSSAuthenticationContext::GetAuthenticator method is called to retrieve a pointer to the authenticator that created the user-authentication object.

Syntax

HRESULT GetAuthenticator (
INSSAuthenticator **pAuth
);

Parameters

[out] pAuth

Specifies a pointer to the authenticator object.

Return Values

This method should return S_OK upon successful completion, or an HRESULT error value.

Remarks

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

HRESULT CUserAuthentication::GetAuthenticator(
          INSSAuthenticator **pAuth )
{
  if( NULL == m_pAuthenticator )
  {
    return( E_NOINTERFACE );
  }
 
  *pAuth = m_pAuthenticator;
  //
  // Addref for the authenticator interface we are about to hand out.
  //
  m_pAuthenticator->AddRef();
  return( S_OK );
}