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