XL2000: Structure and Windows Arguments of Protect Method

ID: Q213543

The information in this article applies to:

Microsoft Excel 2000

SYMPTOMS

In Microsoft Excel, when you run a Visual Basic for Applications subroutine that protects a workbook, you may receive the following error message:

Run-time error '5':
Invalid procedure call or argument

CAUSE

This problem occurs if you attempt to set either the Structure argument or the Windows argument (or both) of the Protect method to a value other than True or False. Although you can do this in versions of Microsoft Excel earlier than Excel 97, you cannot use a value other than True or False in Microsoft Excel 2000.

For example, this line of code does not work:


ActiveWorkbook.Protect Structure:=0, Windows:=1

This behavior is by design of Microsoft Excel.

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 professionals 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 a Microsoft Certified Solution Provider or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Solution Providers, please see the following page on the World Wide Web:

http://www.microsoft.com/mcsp/

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/overview/overview.asp

If you use the Structure and Windows arguments of the Protect method, you must set them to either True or False. For example, use the following line of code:


ActiveWorkbook.Protect Structure:=False, Windows:=True

This code works in Microsoft Excel 2000 and in earlier versions of Microsoft Excel.

MORE INFORMATION

The Structure and Windows arguments of the Protect method allow you to decide whether the structure of the workbook (the relative location of sheet tabs, and whether sheets are hidden) and the workbook's window (size and position on the screen) are protected.

In many programming languages, including Visual Basic for Applications, the Boolean value False is often equal to 0, and you can sometimes substitute the value 0 whenever False is required for the value of an argument. Similarly, the Boolean value True is often equal to any nonzero value (for example, 5), and you can sometimes substitute a nonzero value whenever True is required for the value of an argument.

However, this convention does not apply to the Structure and Windows arguments of the Protect method in Microsoft Excel. The only acceptable values for these arguments are True and False.

Additional query words:

Keywords : kberrmsg kbdta kbdtacode OffVBA KbVBA xlvbmigrate
Version : WINDOWS:2000
Platform : WINDOWS
Issue type : kbprb