. DirectXtras Home
        Home

DirectCommunication Xtra
DirectConnection Xtra
DirectControl Xtra
DirectEmail Xtra
DirectFTP Xtra
DirectImage Xtra
DirectInteraction Xtra
DirectOS Xtra
Documentation
License Agreement
Licensing Fees
Order Form
DirectSMS Xtra
DirectSound Xtra
DirectTransition Xtra
DirectTransition3D Xtra Set I
DirectTransition3D Xtra Set II
DirectTransition3D Xtra Set III
DirectTTS Xtra
XtrAgent
DirectXport Xtra

SpeechPlugin

Special Discounted Bundles

The Gallery
How To Order
Order Form
Check for Upgrades

Sign in
Change Your Profile

Contact Us
















    .
DirectXtras
Xtra Power for Director & Authorware



DirectOS Xtra
 Directing Windows and MacOS. The OS at your fingertips!

Authorware 4.x Compatible Authorware 5.x CompatibleAuthorware 6.x CompatibleAuthorware 7.x CompatibleDirector 5.x Compatible Director 6.x CompatibleDirector 7.x Compatible Director 8.x CompatibleDirector MX Compatible     MacOS 8.x and 9.x CompatibleMacOS X CompatibleWindows Compatible   

dosWriteINI(string FileName, string SectionName, string KeyName, string Data)

Sets the value of the specified key from a specified section of a specified INI file. If the INI file does not exist, it is created. If the specified section does not exist, it is created. If the specified key does not exist, it is created. INI files are text files that allow storage of strings within organized keys within organized sections. INI files are a standard file format, therefore this method may be used to modify INI files created by other applications as long as the INI file conforms to the standard format. 

Parameters :
FileName : A string specifying the drive, location and name of the INI file to modify. For example, "C:\Docs\MyDoc.ini" on Windows or "My Mac:Docs:My Doc" on MacOS. On Windows, all files and folders in the pathname may be specified by their Windows name or MS-DOS name. 
SectionName : A string specifying the section that contains the key whose value to modify. This parameter is case insensitive. This parameter must contain at least one character, no ] and no enters. 
KeyName : A string specifying the key whose value to modify. This parameter is case insensitive. This parameter must contain at least one character, no =, no enters and must not start with a [. 
Data : A string specifying the value to change to for the specified key. This parameter must contain no enters. 

Return Value : An integer indicating whether the method was successful or not. If 1 is returned, the method was successful. If 0 is returned, the method was not successful in which case dosGetLastError() should be called to determine the cause of the error. 

Possible Returned Error Codes via dosGetLastError() :
10002 : Invalid format for parameter 2. The section name is an empty string, contains a ] or contains enters. 
10003 : Invalid format for parameter 3. The key name is an empty string, contains a =, contains enters or starts with a [. 
10004 : Invalid format for parameter 4. The data contains enters. 
10014 : File expected. A reference to a drive or folder was given. 
10020 : Drive is write disabled. 
10024 : Bad INI file. The INI file specified is in an invalid format. 



DirectXtras Inc.
P.O Box 2645, Menlo Park, CA, 94026, U.S.A
Voice: +1-415-5058249, Fax: +1-801-8585841
Toll Free: 1-800-4453093
E-mail General Information: info@directxtras.com
E-mail Technical Support: support@directxtras.com

Copyright 1996-2004 DirectXtras Inc. All Rights Reserved.
WebMaster: tamar@directxtras.com
Last Updated: 2/18/2002 3:19:31 PM.