INSSUserAuthentication::GetAuthenticator

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 must return S_OK upon successful completion, or an HRESULT error code.

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 );
}

See Also

INSSAuthenticator::CreateUserAuthentication