xp_findnextmsg(Transact-SQL)

입력할 메시지 ID를 승인하고 해당 메시지 ID를 반환하여 출력합니다. xp_findnextmsgsp_processmail과 함께 Microsoft SQL Server 받은 편지함에서 메일을 처리하는 데 사용됩니다.

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

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

xp_findnextmsg [ [ @type= ] type ] 
     [ , [ @unread_only= ] 'unread_value' ]
     [ , [ @msg_id= ] 'message_id' [ OUTPUT ] ]

인수

  • [ **@type=**\] type
    MAPI 정의를 기반으로 하는 입력 메시지 유형입니다.

    IP[M|C].Vendorname.subclass

    type이 NULL인 경우 IPM으로 시작하는 메시지 유형은 메일 클라이언트의 받은 편지함에 표시되고 xp_findnextmsg를 사용하여 찾거나 읽습니다. IPC로 시작하는 메시지 유형은 메일 클라이언트의 받은 편지함에 표시되지 않으며 type 매개 변수를 설정하여 찾거나 읽어야 합니다. 기본값은 NULL입니다. SQL 메일은 IPMIPC 유형의 메시지를 지원합니다.

  • [ **@unread\_only=**\] 'unread_value'
    읽지 않은(N'TRUE') 메시지만 나타낼지 여부입니다. 기본값은 **N'FALSE'**이며 모든 메시지를 나타낸다는 의미입니다. unread_valuenvarchar(5) 유형입니다.
  • [ **@msg\_id=**\] 'message_id'
    입력에 관한 메시지의 문자열 및 출력에 관한 다음 메시지의 문자열을 지정하는 입력 및 출력 매개 변수입니다. 입력에 대한 message_id가 NULL이면 기본적으로 **@msg\_id** 출력은 받은 편지함에서 가장 최근에 배달된 메시지의 ID가 됩니다. message_id는 **varchar(255)**이며 기본값은 NULL입니다.
  • OUTPUT
    이 인수를 지정하면 message_id가 출력 매개 변수에 배치됩니다. 지정하지 않으면 message_id가 단일 열, 단일 행 결과 집합으로 반환됩니다.

반환 코드 값

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

결과 집합

xp_findnextmsg는 유효한 메시지 ID를 전달할 때 메시지를 반환합니다.

**@msg\_id**가 NULL이면 xp_findnextmsg는 다음과 같은 결과 집합을 반환합니다.

열 이름 데이터 형식 설명

메시지 ID입니다.

varchar(255)

다음 메시지의 메시지 ID입니다.

주의

잘못된 매개 변수를 제외한 모든 오류는 Microsoft Windows 응용 프로그램 로그에 기록됩니다.

사용 권한

sysadmin 고정 서버 역할의 멤버 자격이 필요하지만 EXECUTE 권한을 다른 사용자에게 부여할 수도 있습니다. 그러나 보안상의 이유로 이 저장 프로시저의 사용 권한을 sysadmin 고정 서버 역할의 멤버로 제한하는 것이 좋습니다.

다음 예에서는 다음 메시지 ID(읽지 않은 메시지만 해당)를 찾을 때 상태를 검색합니다. xp_findnextmsg의 값은 로컬 변수인 @message_id에 배치됩니다.

DECLARE @status int, @message_id varchar(255) ;

EXEC @status = xp_findnextmsg @msg_id = @message_id OUTPUT ;

참고 항목

참조

sp_processmail(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)
xp_deletemail(Transact-SQL)
xp_readmail(Transact-SQL)
xp_sendmail(Transact-SQL)
xp_startmail(Transact-SQL)
xp_stopmail(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기