Artikel
03/30/2012

xp_startmail (Transact-SQL)

Startet eine SQL Mail-Clientsitzung. Durch das Starten einer Mailsitzung werden die MAPI-Clientkomponenten geöffnet und die Anmeldung am E-Mail-Server vorgenommen.

Hinweis
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

xp_startmail [ [ @user= ] 'mapi_profile_name' ]
     [ , [ @password= ] 'mapi_profile_password' ]

Argumente

[ @user = ] 'mapi_profile_name'
Ein optionaler Parameter zum Angeben eines E-Mail-Profilnamens. mapi_profile_name ist vom Datentyp sysname und hat keinen Standardwert. Wird dieser Parameter nicht angegeben, wird das in Microsoft Outlook konfigurierte Standardprofil verwendet.
[ @password = ] 'mapi_profile_password'
Das E-Mail-Kennwort für den angegebenen Wert für mapi_profile_name. mapi_profile_password ist vom Datentyp sysname und hat keinen Standardwert. Der Wert NULL ist zulässig, wenn der Mailclient (auf demselben Computer) gestartet wird, bevor xp_startmail ausgeführt wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

xp_startmail gibt die folgende Meldung zurück:

SQL mail session started.

Hinweise

Wenn mapi_profile_name und mapi_profile_password angegeben werden, wird von SQL Server versucht, sich mithilfe dieses Profilnamens und Kennwortes am MAPI-Anbieter anzumelden. Wenn mapi_profile_name und mapi_profile_password angegeben werden, die Angaben jedoch falsch sind, wird eine Fehlermeldung zurückgegeben. Wenn mapi_profile_name und mapi_profile_password nicht angegeben werden, wird von SQL Server der Profilnamen und das Kennwort verwendet, der bzw. das im Dialogfeld SQL Mail-Konfiguration angegeben ist. Wenn der Profilname und das Kennwort nicht explizit bereitgestellt werden, versucht SQL Server, sich mit dem MAPI-Standardprofil bei dem MAPI-Anbieter anzumelden. Einige MAPI-Anbieter sind möglicherweise so konfiguriert, dass sie die Windows-Authentifizierung verwenden. In diesem Fall wird das MAPI-Kennwort ignoriert.

Hinweis
Wenn Sie Mailsitzungen mit xp_startmail starten, können Sie optional Ihren Anmeldenamen und Ihr Kennwort angeben, um diese Informationen nicht an der Eingabeaufforderung eingeben zu müssen. SQL Mail wird jedoch nicht ausgeführt, wenn hierdurch eine bereits vorhandene MAPI-Sitzung überlagert würde. Dieses Verhalten unterscheidet sich von SQL Server, Version 7.0, und früheren Versionen.

Wenn bereits eine Mailsitzung aktiv ist, startet xp_startmail keine neue Mailsitzung. Wenn die Mailfunktion auf demselben Computer verwendet wird, auf dem auch SQL Server ausgeführt wird, muss der Mailclient entweder vor der Ausführung von xp_startmail gestartet werden, oder, falls SQL Mail gemäß Konfiguration automatisch mit SQL Server gestartet wird, vor dem Starten von SQL Server gestartet werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin, EXECUTE-Berechtigungen können jedoch auch anderen Benutzern erteilt werden. Aus Sicherheitsgründen wird jedoch empfohlen, die Berechtigungen für diese gespeicherte Prozedur auf Mitglieder der festen Serverrolle sysadmin zu beschränken.

Beispiele

Im folgenden Beispiel wird eine Mailsitzung mithilfe des Benutzernamens und des Kennwortes gestartet, die in Microsoft Outlook als Standardprofil für das Microsoft Windows-Konto angegeben sind, unter dem SQL Server ausgeführt wird.