Basic Programming Reference Manual
Total Page:16
File Type:pdf, Size:1020Kb
Basic Programming Reference Manual P/N 028156 The names, places, and/or events used in this publication are not intended to correspond to any individual, group, or association existing, living, or otherwise. Any similarity or likeness of the names, places, and/or events with the names of any individual, living or otherwise, or that of any group or association is purely coincidental and unintentional. NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product or related information described herein is only furnished pursuant and subject to the terms and conditions of a duly executed agreement to purchase or lease equipment or to license software. The only warranties made by Unisys, if any, with respect to the products described in this document are set forth in such agreement. Unisys cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material, including direct, special, or consequential damages. You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions. © 1993 Unisys Corporation. All rights reserved. RESTRICTED RIGHTS LEGEND Use, reproduction, or disclosure is subject to the restrictions set forth in DFARS 252.227–7013 and FARS 52.227–14 for commercial computer software. Attachmate and the Attachmate logo are registered trademarks of Attachmate Corporation in the United States and other countries. INFOConnect is a trademark and Unisys is a registered trademark of Unisys Corporation. All other trademarks and registered trademarks are property of their respective owners. The names, places, and/or events used in this publication are not intended to correspond to any individual, group, or association existing, living, or otherwise. Any similarity or likeness of the names, places, and/or events with the names of any individual, living or otherwise, or that of any group or association is purely coincidental and unintentional. NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product or related information described herein is only furnished pursuant and subject to the terms and conditions of a duly executed agreement to purchase or lease equipment or to license software. The only warranties made by Unisys, if any, with respect to the products described in this document are set forth in such agreement. Unisys cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material, including direct, special, or consequential damages. You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions. RESTRICTED RIGHTS LEGEND. Use, reproduction, or disclosure is subject to the restrictions set forth in DFARS 252.227–7013 and FARS 52.227–14 for commercial computer software. Correspondence regarding this publication may be forwarded using the Documentation Questionnaire in this document, or may be addressed directly to Unisys, INFOConnect Development Group, Malvern Development Center, 2450 Swedesford Road, Room B101, Paoli, Pennsylvania, 19301. Unisys and INFOConnect are trademarks of Unisys Corporation. Microsoft is a registered trademark and Windows and Visual Basic are trademarks of Microsoft Corporation. XVT is a trademark of XVT Software Inc. IBM is a registered trademark of International Business Machines Corporation. Novell is a registered trademark of Novell, Inc. Contents About this Manual ...................................................................xxi Section 1 Introduction ICS Accessory API .............................................................1–2 ICS Library API ...................................................................1–2 Section 2 Functions By Category ICS Accessory API .............................................................2–1 MS-Windows API........................................................2–2 XVT/Win API...............................................................2–3 ICS DosLink Client/Server Applications...........................2–5 ICS Memory Management API...........................................2–6 MS-Windows API........................................................2–6 XVT/Win API...............................................................2–6 General Utilities ..................................................................2–7 MS-Windows API........................................................2–8 XVT/Win API...............................................................2–9 ICS Library API .................................................................2–10 Entry Points Provided by SLs and EILs ....................2–10 MS-Windows API...............................................2–11 ICS Utilities for Library Development........................2–12 MS-Windows API...............................................2–12 Section 3 INFOConnect API IcAddRefContextID.............................................................3–2 IcAllocBuffer .......................................................................3–3 IcChangeHandle .................................................................3–4 IC_CHECK_DATAFLAGS...................................................3–6 IC_CHECK_RESULT_SEVERE ..........................................3–7 IcCloseSession...................................................................3–8 IcCreateHandle ...................................................................3–9 IcCreateHwnd....................................................................3–10 IcCreateSession................................................................3–11 IcDefaultErrorProc............................................................3–12 4173 5390–000 v Contents IcDeleteLibraryConfig......................................................3–14 IcDeregisterAccessory ....................................................3–16 IcDestroyHandle...............................................................3–17 IcDestroyHwnd.................................................................3–18 IcDestroySession.............................................................3–19 IcDialogConfig..................................................................3–20 IcExitOk.............................................................................3–21 IcFreeBuffer......................................................................3–22 IcGetBufferSize ................................................................3–23 IcGetChannelID ................................................................3–24 IcGetCmdlineOption ........................................................3–25 IcGetContext.....................................................................3–27 IcGetContextID .................................................................3–28 IcGetContextString ..........................................................3–29 IcGetINFOConnectDir ......................................................3–30 IcGetLibraryDefault..........................................................3–31 IcGetNewPath...................................................................3–32 IcGetNextEvent.................................................................3–34 IcGetPathID.......................................................................3–35 IcGetPathNames...............................................................3–36 IC_GET_RESULT_CONTEXT...........................................3–37 IC_GET_RESULT_SUBTYPE...........................................3–38 IC_GET_RESULT_SUBVALUE........................................3–39 IC_GET_RESULT_TYPE ..................................................3–40 IC_GET_RESULT_VALUE................................................3–41 IcGetServiceName............................................................3–42 IcGetSessionID.................................................................3–43 IcGetSessionInfo..............................................................3–44 IcGetString........................................................................3–45 IcHandleOffset..................................................................3–46 IcInitIcs..............................................................................3–47 IcIsDebug..........................................................................3–48 IcLcl...................................................................................3–49 IcLibCloseChannel...........................................................3–50 IcLibCloseSession ...........................................................3–51 IcLibEvent.........................................................................3–52 IcLibGetSessionInfo ........................................................3–54 IcLibGetString ..................................................................3–55 IcLibIdentifySession ........................................................3–57 IcLibInstall ........................................................................3–58 IcLibLcl..............................................................................3–60