xp_findnextmsg(Transact-SQL)

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

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

구문

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

[ @unread_only=] 'unread_value'
읽지 않은(N'TRUE') 메시지만 나타낼지 여부입니다. 기본값은 **N'FALSE'**이며 모든 메시지를 나타낸다는 의미입니다. unread_value는 nvarchar(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 ;