bcp_colptr

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

현재 복사본의 프로그램 변수 데이터 주소를 SQL Server로 설정합니다.

구문

  
RETCODE bcp_colptr (  
        HDBC hdbc,  
        LPCBYTE pData,  
        INT idxServerCol);  

인수

hdbc
대량 복사 사용 ODBC 연결 핸들입니다.

pData
복사할 데이터에 대한 포인터입니다. 바인딩된 데이터 형식이 큰 값 형식(예: SQLTEXT 또는 SQLIMAGE) 인 경우 pData 는 NULL일 수 있습니다. NULL pData는 긴 데이터 값이 bcp_moretext 사용하여 청크로 SQL Server로 전송됨을 나타냅니다.

pData가 NULL로 설정되고 바인딩된 필드에 해당하는 열이 큰 값 형식이 아니면 bcp_colptr 실패합니다.

큰 값 형식에 대한 자세한 내용은 bcp_bind 참조하세요.

idxServerCol
데이터 복사 대상인 데이터베이스 테이블 열의 서수 위치입니다. 테이블의 첫 번째 열은 열 1입니다. 열의 서수 위치는 SQLColumns에서 보고됩니다.

반품

SUCCEED 또는 FAIL

설명

bcp_colptr 함수를 사용하면 bcp_sendrow 사용하여 SQL Server에 데이터를 복사할 때 특정 열의 원본 데이터 주소를 변경할 수 있습니다.

처음에 사용자 데이터에 대한 포인터는 bcp_bind 호출에 의해 설정됩니다. 프로그램 변수 데이터 주소가 bcp_sendrow 호출 간에 변경되면 bcp_colptr 호출하여 데이터에 대한 포인터를 다시 설정할 수 있습니다. 다음 bcp_sendrow 호출은 bcp_colptr 호출로 주소가 지정된 데이터를 보냅니다.

테이블의 데이터 주소를 수정하려는 모든 열에 대해 별도의 bcp_colptr 호출이 있어야 합니다.

참고 항목

대량 복사 함수