CDBException::m_strStateNativeOrigin

Remarks

Contains a string describing the error that caused the exception. The string is of the form “State:%s,Native:%ld,Origin:%s”, where the format codes, in order, are replaced by values that describe:

• The SQLSTATE, a null-terminated string containing a five-character error code returned in the szSqlState parameter of the ::SQLError function. SQLSTATE values are listed in Appendix A, “ODBC Error Codes,” in the ODBC SDK Programmer’s Reference. Example: “S0022”.
  
  
• The native error code, specific to the data source, returned in the pfNativeError parameter of the ::SQLError function. Example: 207.
  
  
• The error message text returned in the szErrorMsg parameter of the ::SQLError function. This message consists of several bracketed names. As an error is passed from its source to the user, each ODBC component (data source, driver, Driver Manager) appends its own name. This information helps to pinpoint the origin of the error. Example: [Microsoft][ODBC SQL Server Driver][SQL Server]

The framework interprets the error string and puts its components into m_strStateNativeOrigin; if m_strStateNativeOrigin contains information for more than one error, the errors are separated by newlines. The framework puts the alphanumeric error text into m_strError.

For additional information about the codes used to make up this string, see the ::SQLError function in the ODBC SDK Programmer’s Reference.

Example

From ODBC: “State:S0022,Native:207,Origin:[Microsoft][ODBC SQL Server Driver][SQL Server] Invalid column name ‘ColName’”

In m_strStateNativeOrigin: “State:S0022,Native:207,Origin:[Microsoft][ODBC SQL Server Driver][SQL Server]”

In m_strError: “Invalid column name ‘ColName’”

CDBException Overview |  Class Members |  Hierarchy Chart

See Also   CDBException::m_strError