. 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   

dosCreateLink(string LinkAtName, string LinkToName, string Args, string WorkingFolder, string IconLocation, integer HotKey, string State)

Creates a link at LinkAtName linking to the file or folder at LinkToName. On Windows a link is known as a shortcut, on MacOS a link is known as an alias. 

Parameters :
LinkAtName : A string specifying the drive, location and name of the link to create. For example, "C:\Docs\MyLink.lnk" on Windows or "My Mac:Docs:My Link" on MacOS. On Windows, all files and folders in the pathname may be specified by their Windows name or MS-DOS name. 
LinkToName : A string specifying the drive, location and name of the file or folder to create a link to. For example, "C:\Docs\MyDoc.txt" 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. 
Args : On Windows, A string specifying the command line parameters to pass to the target application. This parameter may be an empty string. On MacOS, this parameter is ignored. 
WorkingFolder : On Windows, a string specifying the drive, location and name of the working folder to start the target application in. For example, "C:\MyFolder". On MacOS, this parameter is ignored. 
IconLocation : On Windows, a string specifying the drive, location and name of the .ico icon file to use as the icon for the link. For example, "C:\MyIcon.ico". Note that error checking is not performed to verify that this is a valid icon file. On MacOS, this parameter is ignored. 
HotKey : On Windows, an integer specifying the hot key for the link. This number is a sum of one or more of the following key values plus the virtual key code of an additional key:

Shift - 256
Control - 512
Alt - 1024

For example, to set HotKey to the combination of ALT + B, set this parameter to 1090, which is the sum of 1024 (Alt key) + 66 (the virtual key code of the key B).

Please refer to the dosGetKeyState() function for a complete list of virtual key codes. The created link will be invoked whenever the specified HotKey is pressed. This parameter is ignored on MacOS. 

State : On Windows, a case insensitive string that specifies the show state of the window as brought up by the link. This parameter is ignored on MacOS. 
Possible Values :
"Normal" : Window brought up by link will be normal.
"Minimized" : Window brought up by link will be minimized.
"Maximized" : Window brought up by link will be maximized.

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() :
10001 : Invalid value for parameter 1. The location to create the link in does not exist. 
10002 : Invalid value for parameter 2. The target file or folder does not exist. 
10003 : Invalid value for parameter 3. The supplied arguments are invalid. 
10004 : Invalid value for parameter 4. The working folder specified does not exist or is a file. 
10005 : Invalid value for parameter 5. The icon file specified does not exist or is a folder. 
10006 : Invalid value for parameter 6. Invalid hot key specified. 
10007 : Invalid value for parameter 7. Invalid state specified. 
10020 : Drive is write disabled. The disk to create the link in is write disabled. 



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:09:06 PM.