开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 书籍源码 > 查看源码
OLEDBErrorChecking.h
资源名称：vc++6.0数据库编程大全（代码）.rar　[点击查看]
上传用户：benben_wyd
上传日期：2010-02-26
资源大小：1229k
文件大小：22k
源码类别：

书籍源码

开发平台：

Visual C++

OLEDBErrorChecking.h：源码内容
  1. #ifndef Chucks_Error_Routine_Included
  2. #define Chucks_Error_Routine_Included
  3. #include <oledberr.h>
  4. #include <atldbcli.h>
  6. class COLEDBErrorChecking {
  7. public:
  8. //Inline functions
  9. BOOL DBErrorsAreSupported(CComPtr<IUnknown> m_spUnk)
  10. {
  11. CComPtr<ISupportErrorInfo> spSupportErrorInfo;
  12. if (SUCCEEDED(
  13. m_spUnk->QueryInterface(IID_ISupportErrorInfo,
  14. (void **) &spSupportErrorInfo))) {
  15. if (SUCCEEDED(
  16. spSupportErrorInfo->
  17. InterfaceSupportsErrorInfo(IID_ICommandPrepare))){
  18. return TRUE;
  19. }
  20. }
  21. return FALSE;
  22. }
  23. void GetDBErrors(CComPtr<IUnknown> m_spUnk, char *msg)
  24. {
  25. CDBErrorInfo errInfo;
  26. IErrorInfo *pErrorInfo = NULL;
  27. BSTR pErrorDescription = NULL;
  28. ULONG ulRecords = 0;
  29. HRESULT hr = 
  30. errInfo.GetErrorRecords(m_spUnk, 
  31. IID_ICommandPrepare, &ulRecords);
  32. if (FAILED(hr) || hr == S_FALSE || ulRecords == 0) {
  33. //The error info object could not be retrieved
  34. strcat(msg, "nnCould not retrieve an error info object.");
  35. strcat(msg, "nTherefore, additional error information is not available.");
  36. }
  37. else {
  38. // Error info object was retrieved successfully
  39. LCID lcid = GetUserDefaultLCID();
  40. for (ULONG loop = 0; loop < ulRecords; loop ++) {
  41. // Get the error information from the source
  42. hr = errInfo.GetErrorInfo(loop, lcid, &pErrorInfo);
  43. if (FAILED(hr)) {
  44. continue;
  45. }
  46. //Get the error description
  47. pErrorInfo->GetDescription(&pErrorDescription);
  48. //Convert error description to single-width character
  49. sprintf(msg, "%snn%S", msg, pErrorDescription);
  50. //Get SQLState and Error Code
  51. GetSQLCodes(msg, &errInfo, loop);
  52. //Clean up
  53. SysFreeString(pErrorDescription);
  54. pErrorInfo->Release();
  55. }
  56. }
  57. }
  58. void DisplayDBErrors(CComPtr<IUnknown> m_spUnk, char *msg)
  59. {
  60. //Allow 1 k for the error message
  61. char message[1024];
  62. if (msg) 
  63. strcpy(message, msg);
  64. else
  65. strcpy (message, "");
  66. if (m_spUnk) 
  67. if (DBErrorsAreSupported(m_spUnk)) 
  68. GetDBErrors(m_spUnk, message);
  69. else
  70. DisplaySingleError();
  71. else
  72. DisplaySingleError();
  73. }
  74. void DisplayAllErrors(CComPtr<IUnknown> m_spUnk, 
  75. char *msg = NULL, 
  76. HRESULT hresult = S_OK, 
  77. char *strFunction = NULL)
  78. {
  79. //Allow 1 k for the error message
  80. char message[1024];
  81. if (msg) 
  82. strcpy(message, msg);
  83. else
  84. strcpy (message, "");
  85. if (strFunction) { //Check for function equal to null
  86. //Function was passed, so see what function it was
  87. strcat(message, " in the ");
  88. strcat(message, strFunction);
  89. strcat(message, " function ");
  90. }
  91. if (FAILED(hresult)) {
  92. GetHRRESULTMessage(hresult, message);
  93. }
  94. DisplayDBErrors(m_spUnk, message);
  95. }
  96. //Static functions
  97. static void DisplaySingleError(HRESULT hresult = S_OK, char *strFunction = NULL)
  98. {
  99. //Allow 1 k for the error message
  100. char msg[1024];
  101. strcpy (msg, "");
  102. if (strFunction) { //Check for function equal to null
  103. //Function was passed, so see what function it was
  104. strcat(msg, "Error occurred in the ");
  105. strcat(msg, strFunction);
  106. strcat(msg, " function n");
  107. }
  108. if (FAILED(hresult)) {
  109. GetHRRESULTMessage(hresult, msg);
  110. }
  111. GetSingleError(msg);
  112. ::MessageBox(NULL, msg, "Error Message", MB_OK);
  113. }
  114. static void GetSingleError(char *msg) 
  115. {
  116. IErrorInfo *pErrorInfo = NULL;
  117. BSTR pErrorDescription = NULL;
  118. if (SUCCEEDED(GetErrorInfo(0, &pErrorInfo))) {
  119. //Get the error description
  120. if (SUCCEEDED(pErrorInfo->GetDescription(&pErrorDescription))) {
  121. //Convert error description to single-width character
  122. sprintf(msg, "%snn%S", msg, pErrorDescription);
  123. //Clean up
  124. SysFreeString(pErrorDescription);
  125. }
  126. else {
  127. strcat(msg, "Could not find the error description");
  128. }
  129. pErrorInfo->Release();
  130. }
  131. else {
  132. strcat(msg, "Could not retrieve error information");
  133. }
  134. }
  135. static void GetSQLCodes(char *msg, CDBErrorInfo *errInfo, ULONG errorNum = 0)
  136. {
  137. //COM Error Interface to retrieve error codes
  138. CComPtr<ISQLErrorInfo> spSQLErrorInfo;
  139. char SQLState[100]; //Buffer for error message
  140. if (SUCCEEDED(errInfo->GetCustomErrorObject(errorNum, 
  141. IID_ISQLErrorInfo,
  142. (IUnknown**) &spSQLErrorInfo))) {
  143. BSTR bstrSQLState = NULL; //SQLState that's returned
  144. LONG errorCode; //SQL Code that's returned
  145. //Retrieve the error code and SQLState
  146. if (SUCCEEDED(spSQLErrorInfo->GetSQLInfo(&bstrSQLState, &errorCode))) {
  147. //Form an error message
  148. sprintf(SQLState, 
  149. "nnSQLState is %SnError code is %ld",
  150. bstrSQLState, errorCode);
  151. //Concatenate the error message to the existing message
  152. strcat(msg, SQLState);
  153. SysFreeString(bstrSQLState); //Clean up
  154. }
  155. else {
  156. strcat(msg, 
  157.    "nnCould not get SQL info.");
  158. }
  159. }
  160. else {    //Something went wrong
  161. strcat(msg, 
  162.    "nnCould not get error or SQLState code.");
  163. }
  164. }
  165. static void DisplayHRRESULTMessage(HRESULT hr, char *strFunction = NULL)
  166. {
  167. if (FAILED(hr)) {
  168. //Allow 1 k for the error message
  169. char message[1024];
  170. strcpy (message, "");
  171. if (strFunction) { //Check for function equal to null
  172. //Function was passed, so see what function it was
  173. strcat(message, "An Error occurred in the ");
  174. strcat(message, strFunction);
  175. strcat(message, " function nn");
  176. }
  177. GetHRRESULTMessage(hr, message);
  178. ::MessageBox(NULL, message, "Database HR Error", MB_OK);
  179. }
  180. }
  181. static void GetHRRESULTMessage(HRESULT hr, char *msg)
  182. {
  183. sprintf(msg, "%snHRESULT was 0x%X:", msg, hr);
  184. switch (hr) {
  185. case DB_E_ABORTLIMITREACHED :
  186. strcat(msg, "nYour execution was aborted because a resource limit has been reached. No results are returned when this error occurs.");
  187. break;
  188. case DB_E_ALREADYINITIALIZED :
  189. strcat(msg, "nYou tried to initialize a data source that has already been initialized.");
  190. break;
  191. case DB_E_BADACCESSORFLAGS :
  192. strcat(msg, "nInvalid accessor flags");
  193. break;
  194. case DB_E_BADACCESSORHANDLE :
  195. strcat(msg, "nInvalid accessor handle");
  196. break;
  197. case DB_E_BADACCESSORTYPE :
  198. strcat(msg, "nThe specified accessor was not a parameter accessor");
  199. break;
  200. case DB_E_BADBINDINFO :
  201. strcat(msg, "nInvalid binding information");
  202. break;
  203. case DB_E_BADBOOKMARK :
  204. strcat(msg, "nInvalid bookmark");
  205. break;
  206. case DB_E_BADCHAPTER :
  207. strcat(msg, "nInvalid chapter");
  208. break;
  209. case DB_E_BADCOLUMNID :
  210. strcat(msg, "nInvalid column ID");
  211. break;
  212. case DB_E_BADCOMPAREOP :
  213. strcat(msg, "nThe comparison operator was invalid");
  214. break;
  215. case DB_E_BADCONVERTFLAG :
  216. strcat(msg, "nInvalid conversion flag");
  217. break;
  218. case DB_E_BADCOPY :
  219. strcat(msg, "nErrors were detected during a copy");
  220. break;
  221. case DB_E_BADDYNAMICERRORID :
  222. strcat(msg, "nThe supplied DynamicErrorID was invalid");
  223. break;
  224. case DB_E_BADHRESULT :
  225. strcat(msg, "nThe supplied HRESULT was invalid");
  226. break;
  227. // case DB_E_BADID :
  228. // DB_E_BADID is deprecated. 
  229. // Use DB_E_BADTABLEID instead.
  230. // break;
  231. case DB_E_BADLOCKMODE :
  232. strcat(msg, "nInvalid lock mode");
  233. break;
  234. case DB_E_BADLOOKUPID :
  235. strcat(msg, "nInvalid LookupID");
  236. break;
  237. case DB_E_BADORDINAL :
  238. strcat(msg, "nThe specified column number does not exist.");
  239. break;
  240. case DB_E_BADPARAMETERNAME :
  241. strcat(msg, "nThe given parameter name is not recognized.");
  242. break;
  243. case DB_E_BADPRECISION :
  244. strcat(msg, "nA specified precision is invalid");
  245. break;
  246. case DB_E_BADPROPERTYVALUE :
  247. strcat(msg, "nThe value of a property is invalid");
  248. break;
  249. case DB_E_BADRATIO :
  250. strcat(msg, "nInvalid ratio");
  251. break;
  252. case DB_E_BADRECORDNUM :
  253. strcat(msg, "nThe specified record number is invalid");
  254. break;
  255. case DB_E_BADROWHANDLE :
  256. strcat(msg, "nInvalid row handle.  This error often occurs when you are at BOF or EOF of a rowset and you try to update your data set.");
  257. break;
  258. case DB_E_BADSCALE :
  259. strcat(msg, "nA specified scale was invalid");
  260. break;
  261. case DB_E_BADSOURCEHANDLE :
  262. strcat(msg, "nInvalid source handle");
  263. break;
  264. case DB_E_BADSTARTPOSITION :
  265. strcat(msg, "nThe rows offset specified would position you before the beginning or past the end of the rowset.");
  266. break;
  267. case DB_E_BADSTATUSVALUE :
  268. strcat(msg, "nThe specified status flag was neither DBCOLUMNSTATUS_OK nor DBCOLUMNSTATUS_ISNULL");
  269. break;
  270. case DB_E_BADSTORAGEFLAG :
  271. strcat(msg, "nOne of the specified storage flags was not supported");
  272. break;
  273. case DB_E_BADSTORAGEFLAGS :
  274. strcat(msg, "nInvalid storage flags");
  275. break;
  276. case DB_E_BADTABLEID :
  277. strcat(msg, "nInvalid table ID");
  278. break;
  279. case DB_E_BADTYPE :
  280. strcat(msg, "nA specified type was invalid");
  281. break;
  282. case DB_E_BADTYPENAME :
  283. strcat(msg, "nThe given type name was unrecognized");
  284. break;
  285. case DB_E_BADVALUES :
  286. strcat(msg, "nInvalid value");
  287. break;
  288. case DB_E_BOOKMARKSKIPPED :
  289. strcat(msg, "nAlthough the bookmark was validly formed, no row could be found to match it");
  290. break;
  291. case DB_E_BYREFACCESSORNOTSUPPORTED :
  292. strcat(msg, "nBy reference accessors are not supported by this provider");
  293. break;
  294. case DB_E_CANCELED :
  295. strcat(msg, "nThe change was canceled during notification; no columns are changed");
  296. break;
  297. case DB_E_CANNOTRESTART :
  298. strcat(msg, "nThe rowset was built over a live data feed and cannot be restarted.");
  299. break;
  300. case DB_E_CANTCANCEL :
  301. strcat(msg, "nThe executing command cannot be canceled.");
  302. break;
  303. case DB_E_CANTCONVERTVALUE :
  304. strcat(msg, "nA literal value in the command could not be converted to the correct type due to a reason other than data overflow.");
  305. break;
  306. case DB_E_CANTFETCHBACKWARDS :
  307. strcat(msg, "nThe rowset does not support backward scrolling.");
  308. break;
  309. case DB_E_CANTFILTER :
  310. strcat(msg, "nThe requested filter could not be opened.");
  311. break;
  312. case DB_E_CANTORDER :
  313. strcat(msg, "nThe requested order could not be opened.");
  314. break;
  315. case DB_E_CANTSCROLLBACKWARDS :
  316. strcat(msg, "nThe rowset cannot scroll backwards.");
  317. break;
  318. case DB_E_CANTTRANSLATE :
  319. strcat(msg, "nCannot represent the current tree as text.");
  320. break;
  321. case DB_E_CHAPTERNOTRELEASED :
  322. strcat(msg, "nThe rowset was single-chaptered and the chapter was not released when a new chapter formation is attempted.");
  323. break;
  324. case DB_E_CONCURRENCYVIOLATION :
  325. strcat(msg, "nThe rowset was using optimistic concurrency and the value of a column has been changed since it was last read.");
  326. break;
  327. case DB_E_DATAOVERFLOW :
  328. strcat(msg, "nA literal value in the command overflowed the range of the type of the associated column");
  329. break;
  330. case DB_E_DELETEDROW :
  331. strcat(msg, "nThe row that is referred to has been deleted.");
  332. break;
  333. case DB_E_DIALECTNOTSUPPORTED :
  334. strcat(msg, "nThe provider does not support the specified dialect");
  335. break;
  336. case DB_E_DUPLICATECOLUMNID :
  337. strcat(msg, "nA column ID was occurred more than once in the specification");
  338. break;
  339. case DB_E_DUPLICATEDATASOURCE :
  340. strcat(msg, "nA new data source is trying to be formed when a data source with that specified name already exists.");
  341. break;
  342. case DB_E_DUPLICATEINDEXID :
  343. strcat(msg, "nThe specified index already exists.");
  344. break;
  345. case DB_E_DUPLICATETABLEID :
  346. strcat(msg, "nThe specified table already exists.");
  347. break;
  348. case DB_E_ERRORSINCOMMAND :
  349. strcat(msg, "nThe command contained one or more errors.");
  350. break;
  351. case DB_E_ERRORSOCCURRED :
  352. strcat(msg, "nErrors occurred.  This message is thrown when an error occurs that is not captured by one of the other error messages.");
  353. break;
  354. case DB_E_INDEXINUSE :
  355. strcat(msg, "nThe specified index was in use.");
  356. break;
  357. case DB_E_INTEGRITYVIOLATION :
  358. strcat(msg, "nA specified value violated the referential integrity constraints for a column or table.");
  359. break;
  360. case DB_E_INVALID :
  361. strcat(msg, "nThe rowset is invalide.");
  362. break;
  363. case DB_E_MAXPENDCHANGESEXCEEDED :
  364. strcat(msg, "nThe number of rows with pending changes has exceeded the set limit.");
  365. break;
  366. case DB_E_MULTIPLESTATEMENTS :
  367. strcat(msg, "nThe provider does not support multi-statement commands.");
  368. break;
  369. case DB_E_MULTIPLESTORAGE :
  370. strcat(msg, "nMultiple storage objects can not be open simultaneously.");
  371. break;
  372. case DB_E_NEWLYINSERTED :
  373. strcat(msg, "nThe provider is unable to determine identity for newly inserted rows.");
  374. break;
  375. case DB_E_NOAGGREGATION :
  376. strcat(msg, "nA non-NULL controlling IUnknown was specified and the object being created does not support aggregation.");
  377. break;
  378. case DB_E_NOCOMMAND :
  379. strcat(msg, "nNo command has been set for the command object.");
  380. break;
  381. case DB_E_NOINDEX :
  382. strcat(msg, "nThe specified index does not exist.");
  383. break;
  384. case DB_E_NOLOCALE :
  385. strcat(msg, "nThe specified locale ID was not supported.");
  386. break;
  387. case DB_E_NOQUERY :
  388. strcat(msg, "nInformation was requested for a query, and the query was not set.");
  389. break;
  390. case DB_E_NOTABLE :
  391. strcat(msg, "nThe specified table does not exist.");
  392. break;
  393. case DB_E_NOTAREFERENCECOLUMN :
  394. strcat(msg, "nSpecified column does not contain bookmarks or chapters.");
  395. break;
  396. case DB_E_NOTFOUND :
  397. strcat(msg, "nNo key matching the described characteristics could be found within the current range.");
  398. break;
  399. case DB_E_NOTPREPARED :
  400. strcat(msg, "nThe command was not prepared.");
  401. break;
  402. case DB_E_NOTREENTRANT :
  403. strcat(msg, "nProvider called a method from IRowsetNotify in the consumer and the method has not yet returned.");
  404. break;
  405. case DB_E_NOTSUPPORTED :
  406. strcat(msg, "nThe provider does not support this method.");
  407. break;
  408. case DB_E_NULLACCESSORNOTSUPPORTED :
  409. strcat(msg, "nNull accessors are not supported by this provider.");
  410. break;
  411. case DB_E_OBJECTOPEN :
  412. strcat(msg, "nAn object was open.");
  413. break;
  414. case DB_E_PARAMNOTOPTIONAL :
  415. strcat(msg, "nNo value given for one or more required parameters.");
  416. break;
  417. case DB_E_PARAMUNAVAILABLE :
  418. strcat(msg, "nThe provider cannot derive parameter info and SetParameterInfo has not been called.");
  419. break;
  420. case DB_E_PENDINGCHANGES :
  421. strcat(msg, "nThere are pending changes on a row with a reference count of zero.");
  422. break;
  423. case DB_E_PENDINGINSERT :
  424. strcat(msg, "nUnable to get visible data for a newly-inserted row that has not yet been updated.");
  425. break;
  426. case DB_E_READONLYACCESSOR :
  427. strcat(msg, "nUnable to write with a read-only accessor.");
  428. break;
  429. case DB_E_ROWLIMITEXCEEDED :
  430. strcat(msg, "nCreating another row would have exceeded the total number of active rows supported by the rowset.");
  431. break;
  432. case DB_E_ROWSETINCOMMAND :
  433. strcat(msg, "nCannot clone a command object whose command tree contains a rowset or rowsets.");
  434. break;
  435. case DB_E_ROWSNOTRELEASED :
  436. strcat(msg, "nAll HROWs must be released before new ones can be obtained.");
  437. break;
  438. case DB_E_SCHEMAVIOLATION :
  439. strcat(msg, "nGiven values violate the database schema.");
  440. break;
  441. case DB_E_TABLEINUSE :
  442. strcat(msg, "nThe specified table was in use.");
  443. break;
  444. case DB_E_UNSUPPORTEDCONVERSION :
  445. strcat(msg, "nRequested conversion is not supported.");
  446. break;
  447. case DB_E_WRITEONLYACCESSOR :
  448. strcat(msg, "nThe given accessor was write-only.");
  449. break;
  450. case DB_S_ASYNCHRONOUS :
  451. strcat(msg, "nThe operation is being processed asynchronously.");
  452. break;
  453. case DB_S_BADROWHANDLE :
  454. strcat(msg, "nInvalid row handle. This error often occurs when you are at BOF or EOF of a rowset and you try to update your data set.");
  455. break;
  456. case DB_S_BOOKMARKSKIPPED :
  457. strcat(msg, "nSkipped bookmark for deleted or non-member row.");
  458. break;
  459. case DB_S_BUFFERFULL :
  460. strcat(msg, "nVariable data buffer full.  Increase system memory, commit open transactions, free more system memory, or declare larger buffers in you database setup.");
  461. break;
  462. case DB_S_CANTRELEASE :
  463. strcat(msg, "nServer cannot release or 
  464. downgrade a lock until the end of the transaction.");
  465. break;
  466. case DB_S_COLUMNSCHANGED :
  467. strcat(msg, "nIn order to reposition to the start of the rowset, the provider had to reexecute the query; either the order of the columns changed or columns were added to or removed from the rowset.");
  468. break;
  469. case DB_S_COLUMNTYPEMISMATCH :
  470. strcat(msg, "nOne or more column types are incompatible. Conversion errors will occur during copying.");
  471. break;
  472. case DB_S_COMMANDREEXECUTED :
  473. strcat(msg, "nThe provider re-executed the command.");
  474. break;
  475. case DB_S_DELETEDROW :
  476. strcat(msg, "nA given HROW referred to a hard-deleted row.");
  477. break;
  478. case DB_S_DIALECTIGNORED :
  479. strcat(msg, "nInput dialect was ignored and text was returned in different dialect.");
  480. break;
  481. case DB_S_ENDOFROWSET :
  482. strcat(msg, "nReached start or end of rowset or chapter.");
  483. break;
  484. case DB_S_ERRORSOCCURRED :
  485. strcat(msg, "nErrors occurred. DB_S_ERRORSOCCURRED flag was set.");
  486. break;
  487. case DB_S_ERRORSRETURNED :
  488. strcat(msg, "nThe method had some errors; errors have been returned in the error array.");
  489. break;
  490. case DB_S_LOCKUPGRADED :
  491. strcat(msg, "nA lock was upgraded from the value specified.");
  492. break;
  493. case DB_S_MULTIPLECHANGES :
  494. strcat(msg, "nUpdating this row caused more than one row to be updated in the data source.");
  495. break;
  496. case DB_S_NONEXTROWSET :
  497. strcat(msg, "nThere are no more rowsets.");
  498. break;
  499. case DB_S_NORESULT :
  500. strcat(msg, "nThere are no more results.");
  501. break;
  502. case DB_S_PARAMUNAVAILABLE :
  503. strcat(msg, "nA specified parameter was invalid.");
  504. break;
  505. case DB_S_PROPERTIESCHANGED :
  506. strcat(msg, "nOne or more properties were changed as allowed by provider.");
  507. break;
  508. case DB_S_ROWLIMITEXCEEDED :
  509. strcat(msg, "nFetching requested number of rows would have exceeded total number of active rows supported by the rowset.");
  510. break;
  511. case DB_S_STOPLIMITREACHED :
  512. strcat(msg, "nExecution stopped because a resource limit has been reached. Results obtained so far have been returned but execution cannot be resumed.");
  513. break;
  514. case DB_S_TYPEINFOOVERRIDDEN :
  515. strcat(msg, "nCaller has overridden parameter type information.");
  516. break;
  517. case DB_S_UNWANTEDOPERATION :
  518. strcat(msg, "nConsumer is uninterested in receiving further notification calls for this reason");
  519. break;
  520. case DB_S_UNWANTEDPHASE :
  521. strcat(msg, "nConsumer is uninterested in receiving further notification calls for this phase");
  522. break;
  523. case DB_S_UNWANTEDREASON :
  524. strcat(msg, "nConsumer is uninterested in receiving further notification calls for this reason.");
  525. break;
  526. case DB_SEC_E_AUTH_FAILED :
  527. strcat(msg, "nAuthentication failed");
  528. break;
  529. case DB_SEC_E_PERMISSIONDENIED :
  530. strcat(msg, "nPermission denied");
  531. break;
  532. case MD_E_BADCOORDINATE :
  533. strcat(msg, "nBad coordinate for the OLAP dataset.");
  534. break;
  535. case MD_E_BADTUPLE :
  536. strcat(msg, "nBad tuple for the OLAP dataset");
  537. break;
  538. case MD_E_INVALIDAXIS :
  539. strcat(msg, "nThe given axis was not valid for this OLAP dataset.");
  540. break;
  541. case MD_E_INVALIDCELLRANGE :
  542. strcat(msg, "nOne or more of the given cell ordinals was invalid for this OLAP dataset.");
  543. break;
  544. #if(OLEDBVER >= 0x0250)
  545. //Errors if OLE DB version is greater than 2.5
  546. case DB_E_BADREGIONHANDLE :
  547. strcat(msg, "nInvalid region handle");
  548. break;
  549. case DB_E_CANNOTFREE :
  550. strcat(msg, "nOwnership of this tree has been given to the provider.  You cannot free the tree.");
  551. break;
  552. case DB_E_COSTLIMIT :
  553. strcat(msg, "nUnable to find a query plan within the given cost limit");
  554. break;
  555. case DB_E_GOALREJECTED :
  556. strcat(msg, "nNo nonzero weights specified for any goals supported, so goal was rejected; current goal was not changed.");
  557. break;
  558. case DB_E_INVALIDTRANSITION :
  559. strcat(msg, "nA transition from ALL* to MOVE* or EXTEND* was specified.");
  560. break;
  561. case DB_E_LIMITREJECTED :
  562. strcat(msg, "nSome cost limits were rejected.");
  563. break;
  564. case DB_E_NONCONTIGUOUSRANGE :
  565. strcat(msg, "nThe specified set of rows was not contiguous to or overlapping the rows in the specified watch region.");
  566. break;
  567. case DB_S_ERRORSINTREE :
  568. strcat(msg, "nErrors found in validating tree.");
  569. break;
  570. case DB_S_GOALCHANGED :
  571. strcat(msg, "nSpecified weight was not supported or exceeded the supported limit and was set to 0 or the supported limit.");
  572. break;
  573. case DB_S_TOOMANYCHANGES :
  574. strcat(msg, "nThe provider was unable to keep track of all the changes. You must refetch the data associated with the watch region using another method.");
  575. break;
  576. #endif //OLEDBVER >= 0x0250
  577. // BLOB ISequentialStream errors
  578. case STG_E_INVALIDFUNCTION :
  579. strcat(msg, "nYou tried an invalid function.");
  580. break;
  581. case S_FALSE :
  582. strcat(msg, "nS_FALSE was returned.  The ISequentialStream data could not be read from the stream object.");
  583. break;
  584. case E_PENDING :
  585. strcat(msg, "nAsynchronous Storage only: Part or all of the data to be written is currently unavailable. For more information, see IFillLockBytes and Asynchronous Storage in MSDN.");
  586. break;
  587. case STG_E_MEDIUMFULL :
  588. strcat(msg, "nThe write operation was not completed because there is no space left on the storage device.");
  589. break;
  590. case STG_E_ACCESSDENIED :
  591. strcat(msg, "nThe caller does not have sufficient permissions for writing this stream object.");
  592. break;
  593. case STG_E_CANTSAVE :
  594. strcat(msg, "nData cannot be written for reasons other than lack of access or space.");
  595. break;
  596. case STG_E_INVALIDPOINTER :
  597. strcat(msg, "nOne of the pointer values is invalid.");
  598. break;
  599. case STG_E_REVERTED :
  600. strcat(msg, "nThe object has been invalidated by a revert operation above it in the transaction tree.");
  601. break;
  602. case STG_E_WRITEFAULT :
  603. strcat(msg, "nThe write operation was not completed due to a disk error.");
  604. break;
  605. // Unknown error
  606. default :
  607. strcat(msg, "nHRESULT returned an unknown error.");
  608. break;
  609. }
  610. }
  611. };
  612. #endif // !defined(Chucks_Error_Routine_Included)