sysmail_update_principalprofile_sp (Transact-SQL)

Aplica-se a: SQL Server

Atualiza a informação sobre uma associação entre um principal e um perfil.

Transact-SQL convenções de sintaxe

Sintaxe

dbo.sysmail_update_principalprofile_sp
    { [ @principal_id = ] principal_id
        | [ @principal_name = ] N'principal_name' }
    , { [ @profile_id = ] profile_id
        | [ @profile_name = ] N'profile_name' }
    , [ @is_default = ] is_default
[ ; ]

Arguments

[ @principal_id = ] principal_id

O ID do utilizador da base de dados ou o papel na msdb base de dados para a associação mudar. @principal_id é int, com um padrão de NULL. Deve ser especificado @principal_id ou @principal_name .

[ @principal_name = ] N'principal_name'

O nome do utilizador da base de dados ou do papel na msdb base de dados para a associação atualizar. @principal_name é sysname, com um padrão de NULL. Deve ser especificado @principal_id ou @principal_name .

[ @profile_id = ] profile_id

O ID do perfil da associação deve mudar. @profile_id é int, com um padrão de NULL. Deve ser especificado @profile_id ou @profile_name .

[ @profile_name = ] N'profile_name'

O nome do perfil da associação deve mudar. @profile_name é sysname, com um padrão de NULL. Deve ser especificado @profile_id ou @profile_name .

[ @is_default = ] is_default

Se este perfil é o perfil padrão para o utilizador da base de dados. Um utilizador de base de dados pode ter apenas um perfil predefinido. @is_defaulté mordido, sem padrão.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

None.

Remarks

Este procedimento armazenado altera se o perfil especificado é o perfil predefinido para o utilizador da base de dados. Um utilizador de base de dados pode ter apenas um perfil privado predefinido.

Quando o nome principal da associação é público ou o ID principal da associação é 0, este procedimento armazenado altera o perfil público. Só pode haver um perfil público predefinido.

Quando @is_default é 1 e o principal está associado a mais do que um perfil, o perfil especificado torna-se o perfil padrão para o principal. O perfil que anteriormente era o perfil predefinido ainda está associado ao principal, mas já não é o perfil predefinido.

O procedimento sysmail_update_principalprofile_sp armazenado está na msdb base de dados e pertence ao esquema dbo . O procedimento deve ser executado com um nome de três partes se a base de dados atual não msdbfor .

Permissões

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Exemplos

A. Defina um perfil para ser o perfil público predefinido de uma base de dados

O exemplo seguinte define o perfil General Use Profile como o perfil público predefinido para os utilizadores na msdb base de dados.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'General Use Profile',
    @is_default = '1';

B. Defina um perfil para ser o perfil privado predefinido de um utilizador

O exemplo seguinte define o perfil AdventureWorks Administrator para ser o perfil padrão do principal ApplicationUser na msdb base de dados. O perfil deve já estar associado ao principal. O perfil que anteriormente era o perfil predefinido ainda está associado ao principal, mas já não é o perfil predefinido.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator',
    @is_default = '1';