Article ID: 160132
Article Last Modified on 8/10/2007
APPLIES TO
- Microsoft Word 97 Standard Edition
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
Additional query words: wordcon word8 word97 8.0 vb vba vbe
Keywords: kbfaq kbinfo kbprogramming KB160132
