GET_TRANSMISSION_STATUS (Transact-SQL)
Retorna o status da última transmissão para um lado de uma conversa.
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çã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.