bcp_colptr
현재 복사본의 프로그램 변수 데이터 주소를 SQL Server로 설정합니다.
구문
RETCODE bcp_colptr (
HDBC hdbc,
LPCBYTE pData,
INT idxServerCol);
인수
hdbc
대량 복사가 가능한 ODBC 연결 핸들입니다.pData
복사할 데이터에 대한 포인터입니다. 바인딩된 데이터 형식이 SQLTEXT 또는 SQLIMAGE와 같은 큰 값 형식이면 pData가 NULL일 수 있습니다. pData가 NULL이면 긴 데이터 값을 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을 호출해야 합니다.