아티클
09/27/2010

xp_startmail(Transact-SQL)

SQL 메일 클라이언트 세션을 시작합니다. 메일 세션을 시작하면 MAPI 클라이언트 구성 요소가 열리고 전자 메일 서버에 로그온됩니다.

[!참고]

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오.

구문

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

인수

[ @user = ] 'mapi_profile_name'
메일 프로필 이름을 지정하는 선택적 매개 변수입니다. mapi_profile_name은 sysname이며 기본값은 없습니다. 이 매개 변수를 제공하지 않은 경우 Microsoft Outlook에 구성되어 있는 기본값이 사용됩니다.
[ @password = ] 'mapi_profile_password'
지정된 mapi_profile_name에 대한 메일 암호입니다. mapi_profile_password은 sysname이며 기본값은 없습니다. 같은 컴퓨터에서 메일 클라이언트가 xp_startmail 실행 전에 시작된 경우에는 NULL 값을 사용할 수 있습니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

xp_startmail은 다음과 같은 메시지를 반환합니다.

SQL mail session started.

주의

mapi_profile_name과 mapi_profile_password가 제공된 경우 SQL Server는 해당 프로필 이름과 암호를 사용하여 MAPI 공급자에 로그온을 시도합니다. mapi_profile_name과 mapi_profile_password가 틀리게 제공되는 경우에는 오류 메시지가 반환됩니다. mapi_profile_name과 mapi_profile_password가 제공되지 않는 경우 SQL Server는 SQL 메일 구성 대화 상자에 지정되어 있는 프로필 이름과 암호를 사용합니다. 사용자 이름이나 암호가 명시적으로 제공되지 않는 경우 SQL Server는 기본 MAPI 프로필을 사용하여 MAPI 공급자에 로그인합니다. MAPI 공급자에 따라 Windows 인증을 사용하도록 구성되어 있으며, 이 경우 MAPI 암호는 무시됩니다.

[!참고]

xp_startmail을 사용하여 메일 세션을 시작하는 경우에는 명령 프롬프트에 입력할 필요가 없도록 선택적으로 로그인 이름 및 암호를 공급할 수 있습니다. 하지만 SQL 메일은 MAPI 세션 하나가 실행 중인 경우에는 기존 MAPI 세션의 맨 위에서 실행되지 않습니다. 이 기능은 SQL Server 7.0 이전 버전과 구별되는 기능입니다.

기존 메일 세션이 있는 경우에는 xp_startmail이 새 세션을 시작하지 않습니다. SQL Server가 실행되고 있는 컴퓨터에서 메일을 실행하는 경우에는 xp_startmail이 실행되기 전 또는 SQL Server가 시작될 때 SQL Mail이 자동으로 시작되도록 구성된 경우에는 SQL Server가 시작되기 전에 메일 클라이언트를 시작해야 합니다.