xp_findnextmsg (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.

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 ;

Consulte também

Referência