Descrição:Encerra um canal PJSIP de entrada e retorna o código de resposta SIP especificado na resposta final para o chamador.
Atenção: Esta função deve ser chamada
ANTES de qualquer ação que possa causar uma resposta final (não 1XX). Por exemplo, chamar 'Answer()' ou 'Playback' sem a opção 'noanswer' fará com que a chamada seja atendida e uma resposta final 200 seja enviada.
O código de causa definido no canal será traduzido para um código de causa ISDN padrão usando a tabela definida em
ast_sip_hangup_sip2cause() em
res_pjsip.c.
Exemplo: Encerra a chamada com o código de resposta 437
Action: PJSIPHangup
ActionID: 12345678
Channel: PJSIP/alice-00000002
Cause: 437
Exemplo: Encerra a chamada com o código de resposta 437 usando o nome do código de resposta
Action: PJSIPHangup
ActionID: 12345678
Channel: PJSIP/alice-00000002
Cause: UNSUPPORTED_CERTIFICATE
Parâmetros:Action: PJSIPHangup
ActionID: <value>
Channel: <value>
Cause: <value>ActionID - ID da ação para esta transação. Será retornado.
Channel - O nome exato do canal a ser encerrado, ou para usar uma expressão regular, defina este parâmetro como: /regex/
Exemplo de canal exato: SIP/provider-0000012aExemplo de expressão regular: /^SIP/provider-.*$/Cause - Pode ser um de...
- Código de resposta - Um código de resposta numérico no intervalo 400 -> 699
- Nome do código de resposta - Um nome de código de resposta de 'third-party/pjproject/source/pjsip/include/pjsip/sip_msg.h' como 'USE_IDENTITY_HEADER' ou 'PJSIP_SC_USE_IDENTITY_HEADER'