Compartilhar via


xp_findnextmsg (Transact-SQL)

Aceita um ID de mensagem para entrada e retorna o ID de mensagem para saída. xp_findnextmsg é usado com sp_processmail a fim de processar email na caixa de entrada do Microsoft SQL Server.

ObservaçãoObservação

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

xp_findnextmsg [ [ @type= ] type ] 
     [ , [ @unread_only= ] 'unread_value' ]
     [ , [ @msg_id= ] 'message_id' [ OUTPUT ] ]

Argumentos

  • [ @type=] type
    É o tipo da mensagem de entrada com base na definição de MAPI:

    IP[M|C].Vendorname.subclass

    Se type for NULL, os tipos de mensagem que iniciarem com IPM apareceram na caixa de entrada do cliente de email e serão encontrados ou lidos por xp_findnextmsg. Os tipos de mensagem que iniciam com IPC não aparecem na caixa de entrada do cliente de email e devem ser encontrados ou l idos pela configuração do parâmetro type. O padrão é NULL. O SQL Mail oferece suporte aos tipos de mensagem IPM e IPC.

  • [ @unread_only=] 'unread_value'
    É o fato de somente mensagens não lidas (N'TRUE') serem consideradas. O padrão é N'FALSE', o que significa que todas as mensagens são consideradas. unread_value é do tipo nvarchar(5).

  • [ @msg_id=] 'message_id'
    É um parâmetro de entrada e saída que especifica a cadeia de caracteres da mensagem na saída e a cadeia de caracteres da próxima mensagem na saída. Se o message_id para a entrada for NULL então, por padrão, a saída @msg_id será o ID da mensagem entregue mais recentemente na caixa de entrada. message_id é varchar(255), com um padrão NULL.

  • OUTPUT
    Quando for especificado, message_id será colocado no parâmetro de saída. Quando não for especificado, message_id será retornado como um conjunto de resultados com uma coluna e uma linha.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

xp_findnextmsg retornará uma mensagem quando um ID de mensagem válido for passado.

Quando @msg_id for NULL, xp_findnextmsg retornará o seguinte conjunto de resultados.

Nome da coluna

Tipo de dados

Descrição

ID da mensagem

varchar(255)

ID da próxima mensagem.

Comentários

Qualquer falha, com exceção de um parâmetro inválido, será registrada no log de aplicativos do Microsoft Windows.

Permissões

Requer associação na função de servidor fixa sysadmin, mas permissões EXECUTE podem ser concedidas a outros usuários. Mas, por razões de segurança, é recomendável que as permissões desse procedimento armazenado sejam limitadas aos membros da função de servidor fixa sysadmin.

Exemplos

O exemplo a seguir recupera o status ao procurar o próximo ID de mensagem (somente para mensagens não lidas). O valor de xp_findnextmsg é colocado na variável local @message_id.

DECLARE @status int, @message_id varchar(255) ;

EXEC @status = xp_findnextmsg @msg_id = @message_id OUTPUT ;