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.
.gif "Observação") Observaçã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. |
.gif "Ícone de vínculo de tópico")
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 ;