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

중요
Microsoft 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
  확장 저장 프로시저 오류 errornum에 대한 설명입니다.

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

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

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

반환 값

SUCCEED 또는 FAIL

주의

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

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

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