WD97: Sample VBA Code to Set, Retrieve .ini File or Registry Information (160132)



The information in this article applies to:

  • Microsoft Word 97 for Windows

This article was previously published under Q160132
IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

SUMMARY

In a Microsoft Visual Basic for Applications macro, you can use the PrivateProfileString property to store and retrieve settings from an .ini file or the Windows registry.

MORE INFORMATION

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 Partner or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Partners, please visit the following Microsoft Web site: For more information about the support options that are available and about how to contact Microsoft, visit the following Microsoft Web site:

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.


The following macro examples use the PrivateProfileString property to set or return a string from a settings file or the Windows registry.

NOTE: If the file, section, or key do not exist, they are created when you run the macro.

The following macro creates a file ("Test.ini"), section ("MySection"), and key ("MyKey") and sets the value of the key to "7."
Sub SetInfo()
   System.PrivateProfileString("Test.ini", "MySection", "MyKey") = "7"
End Sub
				
The following macro returns the value set in the previous macro.
Sub GetInfo()
   MsgBox System.PrivateProfileString("Test.ini", "MySection", "MyKey")
End Sub
				
You cannot delete a key using the PrivateProfileString property, but you can set its argument to an empty string. The following macro deletes the value, but it does not delete the MySection section or the MyKey entry from the Test.ini file.
Sub DelInfo()
   System.PrivateProfileString("Test.ini", "MySection", "MyKey") = ""
End Sub
				
The following macro displays the default user name setting from the Windows registry:
Sub GetUserInfo()
   aName = System.PrivateProfileString("", _
   "HKEY_CURRENT_USER\Software\Microsoft\MS Setup (ACME)\User Info", _
   "DefName")
   MsgBox aName
End Sub
				
For more information about PrivateProfileString, while in the Visual Basic for Applications Editor, click the Office Assistant, type "PrivateProfileString" (without the quotation marks), click Search, and then click to view "PrivateProfileString Property."

NOTE: If the Assistant is hidden, click the Office Assistant button on the Standard toolbar. If Microsoft Visual Basic Help is not installed on your computer, please see the following article in the Microsoft Knowledge Base:

120802 Office: How to Add/Remove a Single Office Program or Component



For information about how to do this in earlier versions of Word, please see the following article in the Microsoft Knowledge Base:

81792 Using Windows Calls to Write to a Private Text File


Modification Type:MinorLast Reviewed:10/11/2006
Keywords:kbinfo kbProgramming KB160132