Changes between Version 14 and Version 15 of FDORfc61

Timestamp:

May 29, 2011, 10:24:01 PM (13 years ago)

Author:

samwang

Comment:

--

FDORfc61

@@ -38 +38 @@
     ///  Create a save point in this transaction.
     /// 
-    /// \param savePointName 
-    /// Save point name.
+    /// \param suggestName
+    /// Suggested save point name.
     /// 
-    FDO_API virtual void AddSavePoint(FdoString* savePointName) = 0;
+    /// \returns 
+    /// The actual name used by the provider 
+    FDO_API virtual FdoString* AddSavePoint(FdoString* suggestName) = 0;
 
     /// \brief
@@ -53 +55 @@
 }
 }}}
-"!AddSavePoint" method is used to add a save point with a specific name which can later be rolled back to without affecting the work done prior to the save point. "Rollback" method rolls back to a named save point.
+"!AddSavePoint" method is used to add a save point with a suggest name which can later be rolled back to without affecting the work done prior to the save point. The suggested name is not necessarily the provider will use beacuse the provider would make sure that the name used to mark the save point is unique. "Rollback" method rolls back to a specific named save point.
 
 The "FdoIConnectionCapabilities" interface also has to be extended to enable query for this capability:
@@ -78 +80 @@
 FdoPtr<FdoIInsert> insertCommand;
 FdoPtr<FdoITransaction> transaction = connection->BeginTransaction();
-transaction->AddSavePoint(L"Save_point_1");
+FdoStringP spName1 = transaction->AddSavePoint(L"Save_point_1");
 try{
 ......
@@ -87 +89 @@
 {
     e->Release();
-    transaction->Rollback(L"Save_point_1");
+    transaction->Rollback(spName1);
 }
-transaction->AddSavePoint(L"Save_point_2");
+
+FdoStringP spName2 = transaction->AddSavePoint(L"Save_point_2");
 FdoPtr<FdoIDelete> deleteCommand;
 try{
@@ -99 +102 @@
 {
     e->Release();
-    transaction->Rollback(L"Save_point_2");
+    transaction->Rollback(spName2);
 }
 transaction->Commit();