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

적용 대상: SQL Server

Important

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

행의 특정 열에 대한 열 이름 및 원본 및 대상 데이터 형식을 정의합니다.

구문

  
int srv_describe (  
SRV_PROC *  
srvproc  
,  
int  
colnumber  
,  
DBCHAR *  
column_name  
,  
int  
namelen  
,  
DBINT  
desttype  
,  
DBINT  
destlen  
,  
DBINT  
srctype  
,  
DBINT  
srclen  
,  
void *  
srcdata  
);  

인수

srvproc
특정 클라이언트 연결에 대한 핸들인 SRV_PROC 구조체에 대한 포인터입니다(이 경우 행을 보내는 클라이언트). 이 구조에는 확장 저장 프로시저 API 라이브러리가 애플리케이션과 클라이언트 간 통신 및 데이터를 관리하는 데 사용하는 모든 정보가 들어 있습니다.

colnumber
현재 지원되지 않습니다. 열을 순서대로 설명해야 합니다. srv_sendrow 호출되기 전에 모든 열을 설명해야 합니다.

column_name
데이터가 속한 열의 이름을 지정합니다. 열에 이름이 필요하지 않으므로 이 매개 변수는 NULL일 수 있습니다.

namelen
column_name 길이(바이트)를 지정합니다. namelen이 SRV_NULLTERM 경우 column_name null로 종료되어야 합니다.

desttype
대상 행 열의 데이터 형식을 지정합니다. 클라이언트로 전송되는 데이터 형식입니다. 데이터가 NULL인 경우에도 데이터 형식을 지정해야 합니다. 자세한 내용은 데이터 형식(확장 저장 프로시저 API)을 참조하세요.

destlen
클라이언트로 전송할 데이터의 길이(바이트)를 지정합니다. null 값을 허용하지 않는 고정 길이 데이터 형식의 경우 destlen 은 무시됩니다. Null 값을 허용하는 고정 길이 데이터 형식 및 가변 길이 데이터 형식의 경우 destlen은 대상 데이터의 최대 길이를 지정합니다.

srctype
원본 데이터의 데이터 형식을 지정합니다.

srclen
원본 데이터의 길이(바이트)를 지정합니다. 고정 길이 데이터 형식의 경우 이 값은 무시됩니다.

srcdata
특정 열의 원본 데이터 주소를 제공합니다. srv_sendrow가 호출되면 srcdata에서 colnumber의 데이터를 찾습니다. 따라서 srv_sendrow 호출하기 전에 해제해서는 안 됩니다. srv_setcoldata를 사용하여 srv_sendrow 호출 사이에 원본 데이터 주소를 변경할 수 있습니다. srcdata에 할당된 메모리는 열 데이터가 다른 srv_setcoldata 호출로 대체되거나 srv_senddone 호출될 때까지 해제되지 않아야 합니다.

desttype이 SRVDECIMAL이나 SRVNUMERIC인 경우 srcdata 매개 변수는 구조의 전체 자릿수 및 소수 자릿수 필드가 원하는 값으로 설정되어 있는 DBNUMERIC 또는 DBDECIMAL 구조에 대한 포인터여야 합니다. DEFAULTPRECISION을 사용하여 기본 전체 자릿수를 지정하고 DEFAULTSCALE을 사용하여 기본 소수 자릿수를 지정할 수 있습니다.

반품

설명되는 열 번호입니다. 첫 번째 열은 열 1입니다. 오류가 발생하면 0을 반환합니다.

설명

srv_sendrow를 처음 호출하기 전에 행의 각 열에 대해 한 번씩, srv_describe 함수를 호출해야 합니다. 행의 열은 순서에 따라 설명될 수 있습니다.

전체 결과 집합이 전송되기 전에 열 행에서 원본 데이터의 위치와 길이를 변경하려면 각각 srv_setcoldata 및 srv_setcollen 사용합니다.

데이터 형식 및 확장 저장 프로시저 API 데이터 형식 변환에 대한 설명은 데이터 형식(확장 저장 프로시저 API)을 참조하세요.

애플리케이션의 열 이름이 유니코드인 경우 srv_describe 호출하기 전에 서버의 멀티바이트 코드 페이지로 변환해야 합니다. 자세한 내용은 유니코드 데이터 및 서버 코드 페이지를 참조 하세요.

Important

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

참고 항목

srv_sendrow(확장 저장 프로시저 API)
srv_setutype(확장 저장 프로시저 API)
srv_setcoldata(확장 저장 프로시저 API)