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

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

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

구문

int srv_wsendmsg(SRV_PROC * 
srvproc
, int 
msgnum
, int 
severity
, WCHAR * 
message
, int 
msglen
);

인수

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

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

• Severity
  오류의 심각도를 지정합니다. 심각도가 10보다 작거나 같으면 정보 메시지로 간주되고 그렇지 않으면 오류로 간주됩니다.

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

• msglen
  message의 길이(문자 수)를 지정합니다.

반환 값

SUCCEED 또는 FAIL

주의

이 함수를 사용하여 유니코드로 메시지를 보낼 수 있습니다. srv_sendmsg와 비슷하지만 DBCHAR 문자열이 아니라 WCHAR 문자열 형식으로 메시지를 보냅니다. 메시지 길이는 바이트가 아니라 문자 수로 보고되며 msglen은 SRV_NULLTERM일 수 없습니다.

이 함수는 다음과 같은 경우 FAIL을 반환합니다.

• 지정된 msglen이 0-32242의 범위를 벗어난 경우

• msglen이 0으로 지정되어 있지만 메시지 포인터가 NULL인 경우

• 네트워크를 통해 오류 메시지를 보낼 때 오류가 발생한 경우

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

참고 항목

참조

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