Using SQLRetrieve to Return Data to a Protected Worksheet

WORKAROUND

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to 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 requirements. To avoid this problem, unprotect the worksheet before you use the SQLRetrieve function. The following macro example shows how to unprotect a worksheet, retrieve the data, and then protect the sheet again.

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