Microsoft KB Archive/178967

= FIX: CRecordset Does Not Set HSTMT Attributes for Updates =

Article ID: 178967

Article Last Modified on 11/21/2006

-

APPLIES TO

 Microsoft Foundation Class Library 4.2, when used with:  Microsoft Visual C++ 5.0 Enterprise Edition

 Microsoft Visual C++ 6.0 Enterprise Edition 

-



This article was previously published under Q178967



SYMPTOMS
When updating using the cursor library or when using a cursor that causes MFC to use SQL statements to update, CRecordset errors can occur when using strings containing ODBC escape sequences. For example, the string [ASCII 147]{d2fcfefb-6126-11d1-84c1-0020afd6c52f}[ASCII 148] may cause a data conversion error because [ASCII 147]{d[ASCII 148] is the ODBC escape sequence for a date. The error occurs whether the SQLSetStmtOption attribute SQL_NOSCAN is set to SQL_NOSCAN_ON or SQL_NOSCAN_OFF.



CAUSE
In the CRecordset::PrepareUpdateHstmt function, CRecordset allocates a handle to use to update m_hstmtUpdate. However, CRecordset does not apply the HSTMT attributes on its default HSTMT, m_hstmt, to m_hstmtUpdate. Therefore any statement attributes set by the user will not be seen in an update.

For example, given the code: void CSampleSet::OnSetOptions(HSTMT hstmt) {     CRecordset::OnSetOptions(hstmt);

SQLSetStmtOption(hstmt, SQL_NOSCAN, SQL_NOSCAN_ON); } updates may fail for fields that contain ODBC escape because m_hstmtUpdate will have the SQL_NOSCAN option turned off. For example you might get a data conversion error from the ODBC driver.



RESOLUTION
It is possible to work around this bug by taking the following steps:

For dynamically linking the MFC library:

<ol> Copy the implementations of CRecordset::UpdateInsertDelete and CRecordset::PrepareUpdateHstmt to your CRecordset derived class.</li> If you haven't already implemented the virtual CRecordset::Update function, copy the MFC implementation of that method.</li>  In the copied CRecordset::PrepareUpdateHstmt, change the block of code that reads if (m_hstmtUpdate == SQL_NULL_HSTMT) {        AFX_SQL_SYNC(::SQLAllocStmt(m_pDatabase->m_hdbc, &m_hstmtUpdate)); if (!Check(nRetCode)) {           TRACE0("Error: failure to allocate update statement.\n"); AfxThrowDBException(nRetCode, m_pDatabase, m_hstmtUpdate); }     } to the following: if (m_hstmtUpdate == SQL_NULL_HSTMT) {        AFX_SQL_SYNC(::SQLAllocStmt(m_pDatabase->m_hdbc, &m_hstmtUpdate)); if (!Check(nRetCode)) {           TRACE0("Error: failure to allocate update statement.\n"); AfxThrowDBException(nRetCode, m_pDatabase, m_hstmtUpdate); }

OnSetOptions(m_hstmtUpdate); }                       </li></ol>

This will ensure that the options set in the virtual function OnSetOptions are applied to the member m_hstmtUpdate.

For statically linking the MFC library, you can either follow the steps above or you can modify your version of MFC sources directly by following step 3 above in the CRecordset class and rebuilding.

It is highly recommended that developers do not directly modify the MFC source. For more information on rebuilding the MFC static library, see the README.TXT file in the MFC\SRC directory.

<div class="status_section">

STATUS
Microsoft has confirmed this to be a bug in the Microsoft products listed at the beginning of this article.

This problem was corrected in Microsoft Visual C++ .NET.

<div class="references_section">