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

적용 대상:SQL Server

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

구문

  
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
메시지의 길이(바이트)를 지정합니다. 메시지가 null로 종료된 경우 msglen을 SRV_NULLTERM 설정합니다.

반품

성공 또는 실패

설명

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

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

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

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