GET_TRANSMISSION_STATUS (Transact-SQL)

Sintaxe

GET_TRANSMISSION_STATUS ( conversation_handle )

Argumentos

• conversation_id
  É o identificador de conversação para a conversação. Este parâmetro é do tipo uniqueidentifier.

Tipos de retorno

nchar

Comentários

Retorna uma cadeia de caracteres que descreve o status da última tentativa de transmissão para a conversação especificada. Retorna uma cadeia de caracteres vazia se a última tentativa de transmissão tiver êxito, se nenhuma tentativa de transmissão for feita ou se conversation_handle não existir.

As informações retornadas por essa função são as mesmas exibidas na coluna last_transmission_error da exibição de gerenciamento sys.transmission_queue. Entretanto, essa função pode ser usada para localizar o status de transmissão para conversações que atualmente não tenham mensagens na fila de transmissão.

Observação
GET_TRANSMISSION_STATUS não fornece informações para mensagens que não tenham um ponto de extremidade de conversação na instância atual. Isto é, nenhuma informação está disponível para as mensagens a serem encaminhadas.

Exemplos

O exemplo a seguir relata o status de transmissão para a conversação com o identificador de conversação 58ef1d2d-c405-42eb-a762-23ff320bddf0.

SELECT Status =
    GET_TRANSMISSION_STATUS('58ef1d2d-c405-42eb-a762-23ff320bddf0') ;

Conjunto de resultados de exemplo, editado para comprimento de linha:

Status

-------------------------------

O transporte de protocolo do Agente de Serviços está desabilitado ou não está configurado.

Nesse caso, o SQL Server não é configurado para permitir que o Service Broker se comunique pela rede.

Consulte também

Tarefas

Referência