srv_message_handler(확장 저장 프로시저 API)

적용 대상: SQL Server

Important

SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 CLR 통합을 사용합니다.

설치된 확장 저장 프로시저 API 메시지 처리기를 호출합니다. 이 함수는 일반적으로 확장 저장 프로시저에서 Microsoft SQL Server를 호출하여 SQL Server 오류 로그 파일 또는 Microsoft Windows 애플리케이션 로그에 오류(확장 저장 프로시저에 의해 정의됨)를 기록하는 데 사용됩니다.

구문

  
int srv_message_handler (  
SRV_PROC *  
srvproc  
,  
int  
errornum  
,  
BYTE   
severity  
,  
BYTE  
state  
,  
int  
oserrnum  
,  
char *  
errtext  
,  
int  
errtextlen  
,  
char *  
oserrtext  
,  
int  
oserrtextlen  
);  

인수

srvproc
특정 클라이언트 연결에 대한 핸들인 SRV_PROC 구조체에 대한 포인터입니다. srvproc 매개 변수에는 애플리케이션과 클라이언트 간 통신 및 데이터를 관리하는 데 사용되는 정보가 들어 있습니다.

errornum
확장 저장 프로시저에서 정의한 오류 번호입니다. 이 숫자는 50,001에서 2,147,483,647까지여야 합니다.

severity
오류에 대한 표준 SQL Server 심각도 값입니다. 이 숫자는 0에서 24까지여야 합니다.

state
오류에 대한 SQL Server 상태 값입니다.

oserrnum
운영 체제 오류 번호입니다. 이 인수는 무시됩니다.

errtext
확장 저장 프로시저 오류 오류 에 대한 설명입니다.

errtextlen
확장 저장 프로시저 오류 문자열 errtext의 길이입니다.

oserrtext
운영 체제 오류 oserrnum에 대한 설명입니다. 이 인수는 무시됩니다.

oserrtextlen
운영 체제 오류 문자열 oserrtext의 길이입니다.

반품

SUCCEED 또는 FAIL

설명

srv_message_handler 함수를 사용하면 확장 저장 프로시저를 SQL Server의 중앙 집중식 오류 로깅 및 보고 기능과 통합할 수 있습니다. SQL Server 경고는 확장 저장 프로시저의 이벤트에 대해 설정할 수 있으며 SQL Server 에이전트 이러한 경고 조건을 모니터링합니다.

오류 메시지가 더 길면 412바이트로 잘립니다.

Important

확장 저장 프로시저의 소스 코드를 철저히 검토해야 하며, 프로덕션 서버에 설치하기 전에 컴파일된 DLL을 테스트해야 합니다. 보안 검토 및 테스트에 대한 자세한 내용은 이 Microsoft 웹 사이트를 참조하세요.