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

중요 정보중요

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

원격 저장 프로시저 호출 매개 변수의 최대 데이터 길이를 반환합니다. 이 함수는 srv_paraminfo 함수로 대체되었습니다.

구문

int srv_parammaxlen ( 
SRV_PROC * 
srvproc 
, 
int 
n  
);

인수

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

  • n
    매개 변수의 번호를 나타냅니다. 첫 번째 매개 변수는 1입니다.

반환 값

매개 변수 데이터의 최대 길이(바이트)입니다. n번째 매개 변수가 없거나 원격 저장 프로시저가 없으면 -1이 반환되고

매개 변수가 다음 Microsoft SQL Server 2005 데이터 형식 중 하나이면 이 함수는 다음 값을 반환합니다.

새 데이터 형식

입력 데이터 길이

BITN

NULL: 1

0: 1

>=255: 해당 없음

<255: 해당 없음

BIGVARCHAR

NULL: 255

0: 255

>=255: 255

<255: 255

BIGCHAR

NULL: 255

0: 255

>=255: 255

<255: 255

BIGBINARY

NULL: 255

0: 255

>=255: 255

<255: 255

BIGVARBINARY

NULL: 255

0: 255

>=255: 255

<255: 255

NCHAR

NULL: 255

0: 255

>=255: 255

<255: 255

NVARCHAR

NULL: 255

0: 255

>=255: 255

<255: 255

NTEXT

NULL: -1

0: -1

>=255: -1

<255: -1

주의

각 원격 저장 프로시저 매개 변수에는 실제 데이터 길이와 최대 데이터 길이가 있습니다. Null 값을 사용할 수 없는 고정 길이의 표준 데이터 형식의 경우 실제 길이와 최대 길이가 같습니다. 가변 길이의 데이터 형식의 경우 데이터 길이가 다를 수 있습니다. 예를 들어 **varchar(30)**로 선언한 매개 변수의 데이터 길이는 최대 10바이트입니다. 이 매개 변수의 실제 길이는 10이고 최대 길이는 30입니다. srv_parammaxlen 함수는 원격 저장 프로시저의 최대 데이터 길이를 가져옵니다. 매개 변수의 실제 길이를 가져오려면 srv_paramlen을 사용합니다.

매개 변수를 사용하여 원격 저장 프로시저를 호출하는 경우 매개 변수를 이름 또는 위치(이름 없음)로 전달할 수 있습니다. 일부 매개 변수는 이름으로 전달하고 일부 매개 변수는 위치로 전달하여 원격 저장 프로시저를 호출하면 오류가 발생합니다. 이 경우에도 SRV_RPC 핸들러는 호출되지만 매개 변수가 없는 것과 같이 처리되며 srv_rpcparams는 0을 반환합니다.

보안 정보보안 정보

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

참고 항목

참조

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

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