bcp_colptr
적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform 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 호출이 있어야 합니다.