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

적용 대상: SQL Server

Important

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

현재 데이터 길이를 변수 길이 열 또는 NULL 값을 허용하는 열의 바이트 단위로 지정합니다.

구문

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);  

인수

srvproc
특정 클라이언트 연결에 대한 핸들인 SRV_PROC 구조체에 대한 포인터입니다. 이 구조에는 확장 저장 프로시저 API 라이브러리가 애플리케이션과 클라이언트 간의 통신 및 데이터를 관리하는 데 사용하는 정보가 포함됩니다.

column
데이터 길이가 지정되는 열의 수를 나타냅니다. 열 번호는 1부터 시작합니다.

렌
열 데이터의 길이(바이트)를 나타냅니다. 길이가 0이면 열 데이터 값이 null입니다.

반품

SUCCEED 또는 FAIL

설명

행의 각 열은 먼저 srv_describe 사용하여 정의해야 합니다. 열 데이터 길이는 srv_describe 또는 srv_setcollen 대한 마지막 호출에 의해 설정됩니다. 행의 가변 길이 데이터(Null로 끝나는 데이터)가 변경되는 경우 srv_sendrow를 호출하기 전에 srv_setcollen을 사용하여 새 길이로 설정해야 합니다. Null 값을 허용하는 열의 경우 desttype이 Null을 허용하는 데이터 형식(예: SRVINTN)으로 설정되어 srv_describe가 호출되었으며, len을 0으로 설정하여 srv_setcollen이 호출되어 Null 데이터가 지정됩니다. 확장 저장 프로시저 API를 사용하여 길이가 0인 데이터를 지정할 수 없습니다.

열의 데이터 형식이 가변 길이 인 경우 len 은 선택되지 않습니다. 고정 길이 열에 대해 호출하면 이 함수는 FAIL을 반환합니다.

Important

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

참고 항목

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