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
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