RFX_Text_Bulk

아티클
02/21/2013

해당 배열에서 ODBC 데이터 원본 열에서 문자 데이터의 여러 행을 전송 된 CRecordset-파생 개체입니다.

void RFX_Text_Bulk(
   CFieldExchange* pFX,
   LPCTSTR szName,
   LPSTR* prgStrVals,
   long** prgLengths,
   int nMaxLength 
);

매개 변수

pFX
CFieldExchange 개체에 대한 포인터.이 개체는 함수의 각 호출의 컨텍스트를 정의 하는 정보가 포함 됩니다.자세한 내용은 문서를 참조 하십시오. 레코드 필드 교환: RFX 작동 방식.
szName
데이터 열의 이름입니다.
prgStrVals
에 대 한 포인터의 배열 LPSTR 값입니다.이 배열의 데이터 소스에서 레코드 집합을 전송 하는 데이터를 저장 합니다.ODBC의 현재 버전에 이러한 값을 유니코드 수 없다는 유의 하십시오.
prgLengths
긴 정수 배열에 대 한 포인터입니다.이 배열의 길이 (바이트)가 가리키는 배열에 있는 각 값의 저장할 prgStrVals.이 길이 null 종결 문자가 포함 되지 않습니다.참고 값 SQL_NULL_DATA 해당 데이터 항목은 Null 값을 포함 하는 경우 저장 됩니다.자세한 내용은 ODBC API 함수를 참조 하십시오. SQLBindCol 에 있는 ODBC SDK 프로그래머 참조.
nMaxLength
최대 허용 길이 가리키는 배열에 저장 된 값의 prgStrVals를 null 종결 문자를 포함 하 여.데이터가 없는 잘릴 수 있도록 충분히 큰 예상 데이터 항목을 수용할 수 있는 값을 전달 합니다.

설명

데이터 원본 열의 ODBC 형식을 가질 수 있습니다 SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, 또는 SQL_NUMERIC.레코드 집합 필드 데이터 멤버의 형식 정의 해야 LPSTR.

초기화할 경우 prgStrVals 및 prgLengths 에 NULL, 하 고를 가리켜 배열 크기를 행 집합 크기를 자동으로 할당 됩니다.

[!참고]

대량 레코드 필드 교환 데이터 원본에서 데이터 레코드 집합 개체에만 전송합니다.레코드 집합을 업데이트할 수 있게 하려면 ODBC API 함수 사용 SQLSetPos.

기사에 대 한 자세한 내용은 참조 하십시오. 레코드 집합: 레코드 페치 대량 (ODBC) 및 RFX (레코드 필드 교환).

예제

수동으로 호출 쓰는 해야를 DoBulkFieldExchange 를 재정의 합니다.호출을 보여 주는이 예제 RFX_Text_Bulk, 뿐만 아니라 호출을 RFX_Long_Bulk, 데이터 전송.이러한 호출은 호출 앞에 CFieldExchange::SetFieldType.매개 변수에 대 한 참고, 대량 RFX 함수 대신 RFX 함수를 호출 해야 합니다.

void CMultiCustomer::DoBulkFieldExchange(CFieldExchange* pFX)
{
   pFX->SetFieldType(CFieldExchange::outputColumn);
   RFX_Long_Bulk(pFX, _T("[CustomerID]"), &m_pCustomerID, &m_pcCustomerID);
   RFX_Text_Bulk(pFX, _T("[ContactFirstName]"), &m_pContactFirstName, &m_pcContactFirstName, 50);
   RFX_Text_Bulk(pFX, _T("[PostalCode]"), &m_pPostalCode, &m_pcPostalCode, 50);
   RFX_Text_Bulk(pFX, _T("[L_Name]"), &m_pL_Name, &m_pcL_Name, 50);
   RFX_Long_Bulk(pFX, _T("[BillingID]"), &m_pBillingID, &m_pcBillingID);

   pFX->SetFieldType(CFieldExchange::inputParam);
   RFX_Text(pFX, _T("Param"), m_strParam);
}