home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / IP7060D1.DSK / RDMEAPR.INF (.txt) < prev    next >
OS/2 Help File  |  1995-05-03  |  12KB  |  241 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Application Programmer's Reference ΓòÉΓòÉΓòÉ
  3.  
  4. This file contains additions and corrections to OS/2 LAN Server Application 
  5. Programmer's Reference Version 3.0  (S96F-8440-00). 
  6.  
  7. Page 1-3: Remove line in API Overview, in Enum Functions section that reads: 
  8. "The Enum function loops to get more data." 
  9.  
  10. Page 3-3: Add this entry to the acc0_resource_name table as the first item: the 
  11. Resource Type of "Drive", and the Name Format of "drive:". 
  12.  
  13. Page 3-31: Change the three references of "client" to "mailslot or semaphore 
  14. client". 
  15.  
  16. Page 3-94: In the Connection category, at the fourth bullet, "structure" should 
  17. be plural. 
  18.  
  19. Page 3-116: The code fragment "NetFileEnum2(...,&f,...)" should be 
  20. "NetFileEnum2(...,&f)"; the resume_key is the last argument. 
  21.  
  22. Page 3-120: Change the Group Membership Information (Level 0) bullet from 
  23. "grpi0_name" to "grui0_name". 
  24.  
  25. Page 3-150: In the Mailslot category, the handle type for DosPeekMailslot is an 
  26. unsigned LSINT.  Insert LSINT. 
  27.  
  28. Page 3-174: A NULL "forwardname" is an error.  A null pointer or string must 
  29. not be used to specify a local computer receiving messages. 
  30.  
  31. Page 3-176: The NetMessageNameXXX APIs refer to the messaging name as a 
  32. "user's" name, but NetMessageNameBufferSend and NetMessageNameFileSend say 
  33. "user or application."  In fact, the term "user or application" is true for all 
  34. messaging names. 
  35.  
  36. Page 3-180: In the Named Pipe category, newer counterparts may be located in 
  37. the OS2386.LIB library.  For more information, see the OS/2 2.0 Control Program 
  38. Programming Reference. 
  39.  
  40. Page 3-185: Near the bottom of the page, "nb0_net_name" should have brackets 
  41. and a semicolon.  Declare it as "nb0_net_name[NETBIOS_NAME_LEN+1];". 
  42.  
  43. Page 3-272: In Note 2, bottom of the page, change "y = 1 or 10."  to omit "or 
  44. 10". Level 10 is not valid for NetWkstaSetInfo. 
  45.  
  46. Page 3-311: In the API declaration, "type" should be the same as "servertype" 
  47. in the listing and the explanation. 
  48.  
  49. Page 3-312: The following sentence should be added to the end of the Remarks 
  50. section: "A NULL value for DOMAIN indicates that the NetServerEnum2 API should 
  51. return information for all domains that the requester is monitoring." 
  52.  
  53. Page 3-322: Near the bottom of the page, "The low-word values of svcc_code" 
  54. should be "...svcs_code". 
  55.  
  56. Page 3-324: Near the top and again at the end of the page, svcs_pid should be 
  57. called the "process" identification number, not the "program" identification 
  58. number. At the end of Service Information (Level 1), "svcs_pid" should be 
  59. "svci1_pid". Both svci1_status and svci2_status should "specify the status of 
  60. network service.  The status bits are defined in service status on page 3-321." 
  61.  
  62. Page 3-325: In the first paragraph, "srvc_code" should be "svcs_code".  In the 
  63. second paragraph, svcs_pid identifies the "process" identification number, not 
  64. the "program" identification number. 
  65.  
  66. Page 3-356: In the Share category, at the third bullet, "structure" should be 
  67. plural. 
  68.  
  69. Page 3-389: In the User category, "usri1_home_dir" can be NULL also.  In the 
  70. "usri1_flags" table at the bottom of the page, UF_SCRIPT must be set (bit 0 
  71. turned on) when adding a user. 
  72.  
  73. Page 3-394: Change the second bullet entry of "usri2_max_storage" to 
  74. "usri11_max_storage". 
  75.  
  76. Page 3-397 and 3-398: In the user_logon_info_2 structure, the field 
  77. "usrlog2_fullname" should be "usrlog2_full_name". 
  78.  
  79. Page 3-373: The third paragraph in the description for Use Category contains a 
  80. sentence that should be removed: "Once a UNC connection is established, users 
  81. or programs can access the remote resource by specifying just the netname of 
  82. the resource."  UNC use means the full UNC name must be used. 
  83.  
  84. Page 3-393: User information is reversed.  On page 3-393, the one-line 
  85. description for User Account Information (Level 10) should be swapped with that 
  86. of User Account Information (Level 11). Level 11 is limited; level 10 is 
  87. available for all users to view all users. 
  88.  
  89. Page 3-394: Near the top of the page, the usri11_parms description should be, 
  90. "points to an ASCIIZ string that is set aside for use by applications.  The 
  91. string can be NULL or it can have as many as MAXCOMMENTSZ + 1 bytes."  It is 
  92. the same as usri2_parms. 
  93.  
  94. Page 3-397: In the User category, "usrlog2_fullname" should be 
  95. "usrlog2_full_name". 
  96.  
  97. Page 3-398: In the user_logoff_info_1 structure, change "usrlog1_code" to 
  98. "usrlogf1_code". Remove the final "_l" from the structure "app_sel_list_l". 
  99.  
  100. Pages 3-410 and 3-425: In the NetUserGetAppSel API and NetUserSetAppSel API 
  101. Remarks section, change the last line in Remarks from "...logged-on user's 
  102. private applications." to "...logged-on user's desktop applications." 
  103.  
  104. Page 3-424: The one-line description of NetUserSetAppSel should read: "The 
  105. NetUserSetAppSel (partially admin) function sets ..." rather than "The 
  106. NetUserSetAppSel (partially admin) function modifies ...". 
  107.  
  108. Page 3-425: In step one insert a second paragraph in Remarks reading: "Domain 
  109. control database subdirectories and files must exist for the user before 
  110. NetUserGetAppSel is called.  The NetUserDCDBInit function can be used to create 
  111. the subdirectories and files." 
  112.  
  113. Page 3-425: Remove "again" from the line that reads: 3. Call NetUserSetAppSel 
  114. again. Add a line to the Remarks section of the NetUserSetAppSel API that 
  115. reads: "The asl_apptype field of the app_sel_list structure is ignored for this 
  116. API." 
  117.  
  118. Page 3-428: The NetUserSetInfo description has the phrase "in the system." 
  119. Change this to, "in the user accounts subsystem (UAS) database." 
  120.  
  121. Page 3-432: The listing in the \IBMLAN\NETSRC\H\DCDB.H file is as follows: 
  122.  
  123. NetUserSetLogonAsn(const char LSFAR *  servername,
  124.                    char LSFAR *        user,
  125.                    short               level,
  126.                    char LSFAR *        buf,
  127.                    unsigned short      buflen);
  128. Remove the count parameter, as it is not in the actual definition. 
  129.  
  130. Page 3-433: Add a line to the Remarks section of the NetUserSetLogonAsn API 
  131. that reads: "The lal_type field of the logon_asn_list structure is ignored for 
  132. this API." Insert a third paragraph in Remarks reading: "In order to add a 
  133. single logon assignment to an existing user logon, the user must 
  134.  
  135.  1. Call NetUserGetLogonAsn. 
  136.  
  137.  2. Add a logon_asn_list structure for the application to be added to the 
  138.     returned buffer. 
  139.  
  140.  3. Call NetUserSetLogonAsn." 
  141.  
  142. Page 3-434: For the API NetUserValidate2, the meaning for ERROR_ACCESS_DENIED 
  143. should be: "The username and password do not correspond to an active account", 
  144. NOT "administrative privilege is required". 
  145.  
  146. Page 3-435: In the User category, NetUserValidate2 API description, remove the 
  147. second sentence under Remarks.  Remove "The behavior of this API is undefined 
  148. if the value of reserved1 is not 0." 
  149.  
  150. Page 3-436 to 3-443: In the UPM category, all the function names can be all 
  151. lowercase or all uppercase, but not mixed-case.  In the listing for syntax, 
  152. change Upmeulgn to upmeulgn.  Do the same for the other four UPM functions. 
  153.  
  154. Page 3-439: After UPM_OK it should say in the return codes, "The user was 
  155. logged off successfully." instead of "The user was logged on successfully." 
  156. Exchange "on" for "off". 
  157.  
  158. Page 3-440: In the UPM category, at the top of the page, change UPMEULGF to 
  159. UPMGULGF (for COBOL interfaces). 
  160.  
  161. Page 3-442: Parameter "type" is an unsigned short, but the real API function 
  162. has this parameter as a pointer to that type. 
  163.  
  164. Page 3-443: In the "upm_user_logon" structure, remotetype should be "short". 
  165.  
  166. Appendix A, page A-3: The USE.H include file declares information pertinent to 
  167. the Use category, and the ACCESS.H include file defines the User category. 
  168. DCDB.H is correctly listed under the User category.  Page A-3 entries should 
  169. read as follows: 
  170.  
  171. API Category  Include Files  Purpose
  172. ------------------------------------------------------------------------
  173. Use           USE.H          Declares structures, constants, and
  174.                              functions that examine or control
  175.                              connections (uses) between requesters and
  176.                              servers.
  177. User          ACCESS.H       Declares structures, constants, and
  178.                              functions that retrieve or control user
  179.                              information.  Used also with functions in
  180.                              the access permissions and group categories.
  181.  
  182. Appendix B, pages 1 - 3: Moving the contents of netoem.dll to netapi.dll 
  183. effected the following changes to the function link-time libraries: 
  184.  
  185. On page B-1, the second sentence that ends "...to a program at run time." 
  186. should read: "to a program at program load time."  The following sentences 
  187. should be inserted as a new second paragraph: 
  188.  
  189.      "Note:  Application developers may wish to use dynamic loading and address 
  190.      resolution instead of the import libraries listed below.  See the IBM OS/2 
  191.      Technical Library Programming Guides for information on dynamic loading 
  192.      and addressing." 
  193.  
  194.  On page B-2, the sentence about NETOEM.LIB should be removed, and the three 
  195.  APIs that are listed should be moved to the above NETAPI.LIB section: 
  196.  
  197.         NetMessageBufferSend
  198.         NetMessageFileSend
  199.         NetServerEnum2
  200.  
  201.  On page B-3, the sentence about NETOEM.LIB should be removed, and the 16 APIs 
  202.  that are listed should be moved to the above NETAPI.LIB section: 
  203.  
  204.         NetAliasAdd        NetAppAdd        NetUserDCDBInit
  205.         NetAliasDel        NetAppDel        NetUserGetAppSel
  206.         NetAliasEnum       NetAppEnum       NetUserSetAppSel
  207.         NetAliasGetInfo    NetAppGetInfo    NetUserGetLogonAsn
  208.         NetAliasSetInfo    NetAppSetInfo    NetUserSetLogonAsn
  209.  
  210.  Note:   LS 3.0 APR lists NetAliasAdd twice ; it should only list it once. 
  211.  
  212.  Page B-3: In the runtime libraries, the "Library  Contents  Directory" table 
  213.  entry for NETOEM.DLL should read: 
  214.  
  215.      NETOEM.DLL    Stub library for legacy applications.   \MUGLIB\DLL
  216.  
  217.  Appendix C, page C-12: The error codes in NETERR.H FOR FTADMIN API are not 
  218.  documented. The following #defines listed in \ibmlan\netsrc\h\neterr.h were 
  219.  left out of the FTADMIN section on page C-12 of Appendix C of the LAN Server 
  220.  Application Programmer's Reference.  They correspond to error values 2529 - 
  221.  2534. 
  222.  
  223.   #define NERR_FTUnableToStart    (NERR_BASE+429) /* The verifier/correcter cannot be started. */
  224.   #define NERR_FTNotInProgress    (NERR_BASE+430) /* The verifier/correcter can't be aborted because it isn't started. */
  225.   #define NERR_FTUnableToAbort    (NERR_BASE+431) /* The verifier/correcter can't be aborted. */
  226.   #define NERR_FTUnabletoChange   (NERR_BASE+432) /* The disk could not be locked/unlocked. */
  227.   #define NERR_FTInvalidErrHandle (NERR_BASE+433) /* The error handle was not recognized. */
  228.   #define NERR_FTDriveNotMirrored (NERR_BASE+434) /* The drive is not mirrored. */
  229.  
  230.  Appendix E, page E-8: The following dependency and the return code need to be 
  231.  documented for DosReadAsyncNmPipe: the buffer size provided as input on the 
  232.  DosReadAsyncNmPipe API has a dependency on the value specified in DOSLAN.INI 
  233.  for /NBS.  The buffer size provided as input must be less than or equal to the 
  234.  value specified for /NBS:xK. If the buffer size is too big, DOS LAN Requester 
  235.  returns return code 122, which has the manifest ERROR_INSUFFICIENT_BUFFER.  It 
  236.  means, "data buffer too small". 
  237.  
  238.  This is true for the DosWriteAsyncNmPipe API as well. 
  239.  
  240.  Page X-5: The lower-case index reference with "g" in NetServerGetInfo on page 
  241.  X-5 should be upper-case "G".