sysmail_delete_profile_sp (Transact-SQL)
データベース メールによって使用されるメール プロファイルを削除します。
構文
sysmail_delete_profile_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
引数
[ @profile_id = ] profile_id
削除するプロファイルのプロファイル ID を指定します。 profile_id のデータ型は int で、既定値は NULL です。 profile_id または profile_name のいずれかを指定する必要があります。[ @profile_name = ] 'profile_name'
削除するプロファイルの名前を指定します。 profile_name のデータ型は sysname で、既定値は NULL です。 profile_id または profile_name のいずれかを指定する必要があります。
リターン コード値
0 (成功) または 1 (失敗)
結果セット
なし
説明
プロファイルを削除しても、そのプロファイルで使用されているアカウントは削除されません。
このストアド プロシージャでは、プロファイルにアクセスできるかどうかに関係なく、プロファイルを削除できます。 ユーザーの既定のプライベート プロファイルや、msdb データベースの既定のパブリック プロファイルを削除する場合は慎重に行ってください。 既定のプロファイルがない場合、sp_send_dbmail には引数としてプロファイルの名前が必要になります。 したがって、既定のプロファイルを削除すると、sp_send_dbmail への呼び出しが失敗する場合があります。 詳細については、「sp_send_dbmail (Transact-SQL)」を参照してください。
ストアド プロシージャ sysmail_delete_profile_sp は msdb データベースにあり、dbo スキーマが所有しています。 現在のデータベースが msdb でない場合、このプロシージャを実行するときには名前に 3 つの要素を指定する必要があります。
権限
このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバーに与えられています。
使用例
次の例では、AdventureWorks Administrator というプロファイルを削除します。
EXECUTE msdb.dbo.sysmail_delete_profile_sp
@profile_name = 'AdventureWorks Administrator' ;
関連項目
参照
データベース メール ストアド プロシージャ (Transact-SQL)