Partilhar via


GET_TRANSMISSION_STATUS (Transact-SQL)

Retorna o status da última transmissão para um lado de uma conversa.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

GET_TRANSMISSION_STATUS ( conversation_handle )

Argumentos

  • conversation_id
    É o identificador de conversa para a conversa. 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 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 informações 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 conversas que atualmente não tenham mensagens na fila de transmissão.

ObservaçãoObservação

GET_TRANSMISSION_STATUS não fornece informações para mensagens que não tenham um ponto de extremidade de conversa 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 com o identificador de conversa 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

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

The Service Broker protocol transport is disabled or not configured.

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

Consulte também

Referência

sys.conversation_endpoints (Transact-SQL)

sys.transmission_queue (Transact-SQL)