SipIncomingAuthentication

The SipIncomingAuthentication event is sent to an application when the media engine requires application assistance when performing authentication of incoming requests. In order for the media engine to send this event to the application, the application must enable authentication by calling the SetChallengeAuthenticationState API procedure.

When an application processes this immediate event, it will have access to a CHALLENGE_AUTHENTICATION structure in memory. The application should inspect the memory structure passed to it to determine the proper course of action for the authentication request.

When an application receives this event, the media engine event callback procedure SIPCALLBACKPROC will have a non zero value assigned for the pEventData parameter. This value is a pointer to the CHALLENGE_AUTHENTICATION structure which contains additional information for this event.