IRowsetFastLoad::Commit(OLE DB)
일괄 삽입되는 행의 끝을 표시하고 행을 SQL Server 테이블에 씁니다. 예제는 IRowsetFastLoad를 통한 데이터 대량 복사(OLE DB) 및 IROWSETFASTLOAD 및 ISEQUENTIALSTREAM을 사용하여 BLOB 데이터를 SQL Server로 보내기(OLE DB)를 참조하십시오.
구문
HRESULT Commit(
BOOL fDone);
인수
- fDone[in]
FALSE인 경우 행 집합은 계속 유효하며 소비자가 행을 추가로 삽입할 수 있습니다. TRUE인 경우 행 집합은 유효하지 않게 되며 소비자가 행을 추가로 삽입할 수 없습니다.
반환 코드 값
S_OK
메서드가 성공했으며 삽입한 모든 데이터가 SQL Server 테이블에 기록되었습니다.E_FAIL
공급자 관련 오류가 발생했습니다. 오류 정보에서 공급자 관련 오류 텍스트를 검색하십시오.E_UNEXPECTED
이전에 IRowsetFastLoad::Commit 메서드에 의해 무효화된 대량 복사 행 집합에서 메서드가 호출되었습니다.
주의
SQL Server Native Client OLE DB 공급자 대량 복사 행 집합은 지연 업데이트 모드 행 집합으로 동작합니다. 사용자가 행 집합을 통해 행 데이터를 삽입하면 삽입된 행은 IRowsetUpdate를 지원하는 행 집합에서 보류 중인 삽입과 같은 방법으로 처리됩니다.
IRowsetUpdate::Update 메서드를 사용하여 보류 중인 행을 SQL Server 인스턴스로 전송하는 것과 같은 방법으로 소비자는 대량 복사 행 집합에 대해 Commit 메서드를 호출하여 삽입된 행을 SQL Server 테이블에 써야 합니다.
소비자가 Commit 메서드를 호출하지 않고 대량 복사 행 집합에 대한 참조를 해제하면 기존에 쓰지 않은 삽입된 행이 모두 손실됩니다.
소비자는 fDone 인수를 FALSE로 설정하고 Commit 메서드를 호출하여 삽입된 행을 일괄 처리할 수 있습니다. fDone을 TRUE로 설정하면 행 집합이 무효화됩니다. 무효화된 대량 복사 행 집합에는 ISupportErrorInfo 인터페이스 및 IRowsetFastLoad::Release 메서드만 지원됩니다.