啟動 SQL 郵件客戶端會話。
xp_startmail [[@user =] 'mapi_profile_name']
[,[@password =] 'mapi_profile_password']
[@user =] 'mapi_profile_name'
是可選參數(shù),指定郵件用戶名。mapi_profile_name 的數(shù)據(jù)類型為 sysname,無默認(rèn)值。
[@password =] 'mapi_profile_password'
是指定的 mapi_profile_name 的郵件密碼。mapi_profile_password 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)值。如果在運(yùn)行 xp_startmail 之前,已在同一臺計(jì)算機(jī)上啟動了郵件客戶程序,則允許使用 NULL 值。
0(成功)或 1(失?。?/P>
xp_startmail 返回下列消息:
SQL mail session started.
如果提供了 mapi_profile_name 和 mapi_profile_password,Microsoft® SQL Server™ 將嘗試使用該用戶名和密碼登錄到 Windows NT Mail(或者其它 MAPI 提供程序)上。如果提供的 mapi_profile_name 和 mapi_profile_password 不正確,將返回錯誤信息。如果沒提供 mapi_profile_name 和 mapi_profile_password,SQL Server 將使用在"SQL Server 屬性"對話框中指定的用戶名和密碼。如果沒有顯式提供用戶名或密碼,SQL Server 將嘗試使用默認(rèn)的 MAPI 配置文件登錄到 MAPI 提供程序。某些 MAPI 提供程序可能被配置為使用 Windows 身份驗(yàn)證,在這種情況下,將忽略 MAPI 密碼。
說明 如果使用 xp_startmail 啟動郵件會話,則可以選擇提供登錄名和密碼,而不必在命令提示符下鍵入。然而,如果有一個現(xiàn)有的 Windows NT Mail 客戶端會話正在運(yùn)行,SQL 郵件將不會寄生在該會話上。該行為不同于 SQL Server 7.0 版和更早的版本。
如果已存在郵件會話,xp_startmail 就不啟動新郵件會話。如果在運(yùn)行 SQL Server 的同一計(jì)算機(jī)上使用郵件,則郵件客戶程序必須在 xp_startmail 執(zhí)行之前或 SQL Server 啟動之前(如果 SQL 郵件配置為在 SQL Server 啟動時自動啟動)啟動。
xp_startmail 的執(zhí)行權(quán)限默認(rèn)授予 master 數(shù)據(jù)庫中的 db_owner 固定數(shù)據(jù)庫角色成員以及 sysadmin 固定服務(wù)器角色成員,但可以授予其他用戶。
下例使用 SQL Server 安裝過程中指定的用戶名和密碼啟動郵件。
USE master
EXEC xp_startmail
下例使用用戶名 janetl 和密碼 abc12345 啟動郵件。
USE master
EXEC xp_startmail 'janetl', 'abc12345'
相關(guān)文章