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

  • 아티클
중요 정보중요

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 말고, 현재 이 기능을 사용하는 응용 프로그램은 가능한 한 빨리 수정하십시오. 대신 CLR 통합을 사용하십시오.

클라이언트에 메시지를 보냅니다.

구문

int srv_sendmsg ( 
SRV_PROC * 
srvproc 
, 
int 
msgtype 
, 
DBINT 
msgnum 
, 
DBTINYINT 
class 
,  
DBTINYINT 
state 
, 
DBCHAR * 
rpcname 
, 
int  
rpcnamelen 
, 
DBUSMALLINT 
linenum 
, 
DBCHAR * 
message 
, 
int 
msglen  
);

인수

  • srvproc
    특정 클라이언트 연결에 대한 핸들(이 경우 언어 요청을 수신한 핸들)인 SRV_PROC 구조에 대한 포인터입니다. 이 구조에는 확장 저장 프로시저 API 라이브러리가 응용 프로그램과 클라이언트 간 통신 및 데이터를 관리하는 데 사용하는 정보가 들어 있습니다.

  • msgtype
    서버에서 정보 메시지 또는 오류 메시지를 보내는지에 따라 SRV_MSG_INFO 또는 SRV_MSG_ERROR가 됩니다.

  • msgnum
    4바이트 메시지 번호입니다.

  • class
    오류 심각도를 지정합니다. 심각도가 10보다 작거나 같으면 정보 메시지로 간주됩니다.

  • state
    현재 메시지의 오류 상태 번호를 제공합니다. 이 오류 상태 번호는 오류의 컨텍스트에 대한 정보를 제공합니다. 유효한 상태 번호는 0에서 255까지입니다.

  • rpcname
    현재 지원되지 않습니다.

  • rpcnamelen
    현재 지원되지 않습니다.

  • linenum
    언어 명령 일괄 처리에서 메시지가 적용되는 줄 번호입니다. 줄 번호는 1부터 시작하며 메시지에 linenum이 적용되지 않으면 0으로 설정됩니다.

  • message
    클라이언트로 보낼 문자열에 대한 포인터입니다.

  • msglen
    message의 길이(바이트)를 지정합니다. message가 Null로 끝나는 경우 msglen을 SRV_NULLTERM으로 설정합니다.

반환 값

SUCCEED 또는 FAIL

주의

클라이언트에 오류 메시지 또는 정보 메시지를 보내는 함수입니다. 보낼 각 메시지에 대해 한 번씩 호출됩니다.

srv_sendrow를 사용하여 모든 행(있는 경우)을 보내기 전후에 srv_sendmsg를 사용하여 순서에 상관없이 클라이언트에 메시지를 보낼 수 있습니다. srv_senddone을 사용하여 완료 상태를 보내기 전에는 모든 메시지(있는 경우)를 클라이언트로 보내야 합니다.

메시지를 유니코드로 보내려면 srv_sendmsg 대신 srv_wsendmsg를 사용합니다.

자세한 내용은 유니코드 데이터 및 서버 코드 페이지를 참조하십시오.

보안 정보보안 정보

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