XL: Using SQLRetrieve to Return Data to a Protected Worksheet

• Microsoft Excel for Windows, versions 5.0
• Microsoft Excel for Windows NT, version 5.0
• Microsoft Excel for Windows 95, versions 7.0, 7.0a
• Microsoft Excel 97 for Windows
• Microsoft Excel for the Macintosh, versions 5.0, 5.0a

SYMPTOMS

In Microsoft Excel, when you use the SQLRetrieve function in a Microsoft Visual Basic for Applications procedure to return data from an ODBC data source to a Microsoft Excel worksheet, you may receive the following error message twice and no data will be retrieved:

   Cannot paste data.

For all other versions of Microsoft Excel listed at the beginning of this article, the SQLRetrieve function returns an Error 2015, which indicates that the function was unable to paste the data to the worksheet. Also, no data is returned to the worksheet.

CAUSE

The error message stated above occurs in Microsoft Excel version 5.0, only when the destination worksheet has been protected and any or all cells in the destination range have been locked.

For Microsoft Excel versions 5.0c and later, SQLRetrieve fails when you attempt to retrieve data to a protected worksheet, regardless of whether the cells have been locked or not.

WORKAROUND

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/support/supportnet/refguide/default.asp

Visual Basic Macro Code Example

   Sub SQLOpen_Example()
      Dim Chan As Variant
      Dim NumberOfColumns As Variant, NumberOfRows As Variant
      Dim ContentsProtected As Boolean
      Dim ObjectsProtected As Boolean, ScenariosProtected As Boolean

      ' Open the Nwind data source and check for connection errors
      Chan = SQLOpen("DSN=Nwind")
      If IsError(channel) Then
         MsgBox SQLError()(3)
         Exit Sub
      End If

      ' Execute the query statement and check for SQL statement errors
      NumberOfColumns = SQLExecQuery(Chan, "SELECT * FROM Customer")
      If IsError(NumberOfColumns) Then
         MsgBox SQLError()(3)
         SQLClose channel
         Exit Sub
      End If

      ' Set an object variable to reference Sheet1
      Set thesheet = Worksheets("Sheet1")
      With thesheet
         ' If sheet is protected, then store the current values
         ' of the ProtectDrawingObjects and ProtectScenarios
         ' properties so they can be reset later.
         If .ProtectContents = True Then
            ContentsProtected = True
            ObjectsProtected = .ProtectDrawingObjects
            ScenariosProtected = .ProtectScenarios

            ' Unprotect the sheet and assume no password is needed
            .Unprotect
         End If
      End With

      ' Retrieve data to worksheet and check for retrieval errors
      NumberOfRows = SQLRetrieve(Chan, Range("Sheet1!A1"), , , True)
      If IsError(NumberOfRows) Then
         MsgBox SQLError()(3)
      End If

      ' Close the connection
      SQLClose Chan

      ' If the sheet was previously protected, then reprotect it
      ' with the original settings. No password is used in this
      ' example.
      If ContentsProtected = True Then
         thesheet.Protect DrawingObjects:=ObjectsProtected, _
            Contents:=True, Scenarios:=ScenariosProtected
      End If
   End Sub

STATUS

Microsoft is researching this problem and will post new information here in the Microsoft Knowledge Base as it becomes available.

REFERENCES

For more information on SQLRetrieve, click the Search button in Microsoft Excel Visual Basic Help and type:

   SQLRetrieve

   Protect

   -or-

   Unprotect