srv_describe(확장 저장 프로시저 API)
.gif "중요 정보") 중요 |
|---|
Microsoft 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 호출 사이에 원본 데이터 주소를 변경할 수 있습니다. srv_setcoldata에 대한 다른 호출에 의해 열 데이터가 바뀌거나 srv_senddone이 호출될 때까지 srcdata에 할당된 메모리를 해제하면 안 됩니다.desttype이 SRVDECIMAL이나 SRVNUMERIC인 경우 srcdata 매개 변수는 구조의 전체 자릿수 및 소수 자릿수 필드가 원하는 값으로 설정되어 있는 DBNUMERIC 또는 DBDECIMAL 구조에 대한 포인터여야 합니다. DEFAULTPRECISION을 사용하여 기본 전체 자릿수를 지정하고 DEFAULTSCALE을 사용하여 기본 소수 자릿수를 지정할 수 있습니다.
반환 값
설명되는 열 번호입니다. 첫 번째 열은 열 1입니다. 오류가 발생하면 0이 반환됩니다.
주의
srv_sendrow를 처음 호출하기 전에 행의 각 열에 대해 한 번씩, srv_describe 함수를 호출해야 합니다. 순서에 관계없이 행의 열을 설명할 수 있습니다.
전체 결과 집합이 전송되기 전에 열 행의 원본 데이터 위치와 길이를 변경하려면 각각 srv_setcoldata 및 srv_setcollen을 사용합니다.
데이터 형식 및 확장 저장 프로시저 API 데이터 형식 변환에 대한 설명은 데이터 형식(확장 저장 프로시저 API)을 참조하십시오.
응용 프로그램의 열 이름이 유니코드로 되어 있으면 srv_describe를 호출하기 전에 서버의 멀티바이트 코드 페이지로 변환해야 합니다. 자세한 내용은 유니코드 데이터 및 서버 코드 페이지를 참조하십시오.
.gif "보안 정보") 보안 정보 |
|---|
확장 저장 프로시저의 원본 코드를 철저히 검토하고 프로덕션 서버에 DLL을 설치하기 전에 컴파일한 DLL을 테스트해야 합니다. 보안 검토 및 테스트에 대한 자세한 내용은 Microsoft 웹 사이트를 참조하십시오. |