开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
AppcCfg.h
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：26k
源码类别：

模拟服务器

开发平台：

C/C++

AppcCfg.h：源码内容
  1. /*****************************************************************************/
  2. /*                                                                           */
  3. /* Header: appccfg.h                                                         */
  4. /*                                                                           */
  5. /* (C) COPYRIGHT Data Connection Ltd 1993 - 2000                             */
  6. /* Copyright (c) Microsoft Corporation.  All rights reserved.                */
  7. /*                                                                           */
  8. /* Header for appccfg.c                                                      */
  9. /*                                                                           */
  10. /*****************************************************************************/
  12. /*****************************************************************************/
  13. /* If appccfg.h not already included then define APPCCFG_INCLUDED to avoid   */
  14. /* it being included again.                                                  */
  15. /*****************************************************************************/
  17. #ifndef APPCCFG_INCLUDED
  18. #define APPCCFG_INCLUDED
  20. #ifdef __cplusplus
  21. extern "C" {
  22. #endif
  24. /*****************************************************************************/
  25. /*                                                                           */
  26. /* HANDLE WINAPI GetAppcConfig( HANDLE hWnd, LPSTR pLocalLu, LPSTR pMode,    */
  27. /*                              LPINT pNumRemLu, INT iMaxRemLu, LPSTR pRemLu,*/
  28. /*                              LPINT pAsyncRetCode)                         */
  29. /*                                                                           */
  30. /* Parameters                                                                */
  31. /* ----------                                                                */
  32. /*                                                                           */
  33. /*  IN      hWnd      Handle of window to which completion is to be posted.  */
  34. /*                    If NULL no completion message will be posted but       */
  35. /*                    pAsyncRetCode must be valid. If hWnd is non-NULL it    */
  36. /*                    must be valid & pAsyncRetCode must be NULL.            */
  37. /*                                                                           */
  38. /*  IN      pLocalLU  Pointer to max 8 byte ASCII local LU name (should be 8 */
  39. /*                    ASCII blanks to request info on Remote LUs partnered   */
  40. /*                    to the default Local LU for this user. If none is      */
  41. /*                    configured then APPC_CFG_ERROR_NO_DEFAULT_LOCAL will   */
  42. /*                    be returned in the LPARAM).                            */
  43. /*                                                                           */
  44. /*  IN      pMode     Pointer to max 8 byte ASCII mode name (usually         */
  45. /*                    "QPCSUPP" for a 5250 emulator)                         */
  46. /*                                                                           */
  47. /*  IN/OUT  pNumRemLu Pointer to int to receive the number of Remote LUs     */
  48. /*                    available. (If more than MaxRemLu then only the first  */
  49. /*                    MaxRemLu of them will have been copied)                */
  50. /*                                                                           */
  51. /*  IN      iMaxRemLu Int giving the max number of Remote LU names the       */
  52. /*                    buffer can hold. (size of buffer in bytes / 9)         */
  53. /*                                                                           */
  54. /*  IN/OUT  pRemLu    Pointer to buffer to receive Remote LUs                */
  55. /*                    The data will be returned as an array of max 8 byte    */
  56. /*                    ASCII strings each followed by a terminating NULL      */
  57. /*                                                                           */
  58. /*  IN/OUT  pAsyncRetCode                                                    */
  59. /*                    Optional pointer to int to take the RetCode on         */
  60. /*                    completion of the async part of the call. Only         */
  61. /*                    required if hWnd is NULL. If the request is not        */
  62. /*                    accepted the value in AsyncRetCode is undefined.       */
  63. /*                    It the request was accepted then until the request is  */
  64. /*                    completed AsyncRetCode will contain the value          */
  65. /*                    APPC_CFG_PENDING. Final values are as in the LPARAM of */
  66. /*                    the completion message. If hWnd != NULL, pAsyncRetCode */
  67. /*                    must be NULL.                                          */
  68. /*                                                                           */
  69. /*                                                                           */
  70. /* Returns                                                                   */
  71. /* -------                                                                   */
  72. /*                                                                           */
  73. /* On Call                                                                   */
  74. /* -------                                                                   */
  75. /*  HANDLE  This VerbId will be returned in the WPARAM of any completion     */
  76. /*          message. (VerbId & APPC_CFG_SUCCESS) evaluates to TRUE if the    */
  77. /*          request was accepted.                                            */
  78. /*                                                                           */
  79. /*          If the above expression evaluates to FALSE then VerbId will      */
  80. /*          have one of the following values:                                */
  81. /*                                                                           */
  82. /*             APPC_CFG_ERROR_NO_APPC_INIT                                   */
  83. /*             APPC_CFG_ERROR_INVALID_HWND                                   */
  84. /*             APPC_CFG_ERROR_BAD_POINTER                                    */
  85. /*             APPC_CFG_ERROR_UNCLEAR_COMPLETION_MODE                        */
  86. /*             APPC_CFG_ERROR_TOO_MANY_REQUESTS                              */
  87. /*             APPC_CFG_ERROR_GENERAL_FAILURE                                */
  88. /*                                                                           */
  89. /*                                                                           */
  90. /*                                                                           */
  91. /* On Receipt of completion message                                          */
  92. /* --------------------------------                                          */
  93. /*  MSG     Equal to return from RegisterWindowMessage with                  */
  94. /*          WIN_APPC_CFG_COMPLETION_MSG passed as message name.              */
  95. /*                                                                           */
  96. /*  WPARAM  VerbId returned on the initiating call.                          */
  97. /*                                                                           */
  98. /*  LPARAM  Retcode which will be one of the following:                      */
  99. /*                                                                           */
  100. /*             APPC_CFG_SUCCESS_NO_DEFAULT_REMOTE                            */
  101. /*             APPC_CFG_SUCCESS_DEFAULT_REMOTE                               */
  102. /*                                                                           */
  103. /*             APPC_CFG_ERROR_NO_DEFAULT_LOCAL_LU                            */
  104. /*             APPC_CFG_ERROR_BAD_LOCAL_LU                                   */
  105. /*             APPC_CFG_ERROR_GENERAL_FAILURE                                */
  106. /*                                                                           */
  107. /*  (Retcode & APPC_CFG_ERROR)   evaluates to TRUE for an error retcode      */
  108. /*  (Retcode & APPC_CFG_SUCCESS) evaluates to TRUE for a success retcode     */
  109. /*                                                                           */
  110. /*                                                                           */
  111. /*                                                                           */
  112. /* Comments                                                                  */
  113. /* --------                                                                  */
  114. /*  This call attempts to get all the remote systems (partner LUs) which can */
  115. /*  be accessed by the logged on user with the given local LU and mode name. */
  116. /*  The final retcode also indicates if there is a default remote system     */
  117. /*  configured.                                                              */
  118. /*                                                                           */
  119. /*  Completion will either be signified by the posting of a completion       */
  120. /*  message or by the change of *pAsyncRetCode to a value other than         */
  121. /*  APPC_CFG_PENDING. The latter mechanism is intended for use by console    */
  122. /*  apps with no windows or on non-Windows platforms. Completion can then    */
  123. /*  be tested by code similar to the below:                                  */
  124. /*                                                                           */
  125. /*                while (*pAsyncRetCode == APPC_CFG_PENDING)                 */
  126. /*                {                                                          */
  127. /*                  sleep(250);                                              */
  128. /*                }                                                          */
  129. /*                                                                           */
  130. /*  Note that one of hWnd & pAsyncRetCode must be NULL and the other valid.  */
  131. /*  If this isn't the case APPC_CFG_ERROR_UNCLEAR_COMPLETION_MODE will be    */
  132. /*  returned.                                                                */
  133. /*                                                                           */
  134. /*  All strings are null terminated and are NOT space padded                 */
  135. /*                                                                           */
  136. /*  If the buffer is too short, the reported number of remote LU's available */
  137. /*  MAY be GREATER than the actual number. (This will only be the case where */
  138. /*  a particular Local Lu is configured at multiple nodes, and has the       */
  139. /*  remote on multiple nodes.) When the call is made again which a buffer    */
  140. /*  large enough to take all the remote LU, the reported number will be      */
  141. /*  correct.                                                                 */
  142. /*                                                                           */
  143. /*  ALL MEMORY TO WHICH POINTERS ARE PASSED MUST REMAIN VALID TILL A         */
  144. /*  COMPLETION MESSAGE IS RECEIVED                                           */
  145. /*                                                                           */
  146. /*  WinAPPCStartup MUST be called first                                      */
  147. /*                                                                           */
  148. /*****************************************************************************/
  149. /*****************************************************************************/
  150. /* Entry point prototype                                                     */
  151. /*****************************************************************************/
  152. extern HANDLE WINAPI GetAppcConfig( HANDLE hWnd, LPSTR pLocalLu, LPSTR pMode,
  153.                                  LPINT pNumRemLu, INT iMaxRemLu, LPSTR pRemLu,
  154.                                  LPINT pAsyncRetCode);
  156. /*****************************************************************************/
  157. /* Completion Message Name                                                   */
  158. /*****************************************************************************/
  159. #define  WIN_APPC_CFG_COMPLETION_MSG "WinAppcCfg"
  161. /*****************************************************************************/
  162. /* Test values                                                               */
  163. /*****************************************************************************/
  164. #define  APPC_CFG_SUCCESS                      0x1000
  165. #define  APPC_CFG_ERROR                        0x2000
  166. #define  APPC_CFG_PENDING                      0xFFFF
  168. /*****************************************************************************/
  169. /* Retcodes                                                                  */
  170. /*****************************************************************************/
  171. #define  APPC_CFG_SUCCESS_NO_DEFAULT_REMOTE     (APPC_CFG_SUCCESS + 1)
  172. #define  APPC_CFG_SUCCESS_DEFAULT_REMOTE        (APPC_CFG_SUCCESS + 2)
  173. #define  APPC_CFG_SUCCESS_NAMES                 (APPC_CFG_SUCCESS + 3)
  174. #define  APPC_CFG_SUCCESS_NAMES_INCOMPLETE      (APPC_CFG_SUCCESS + 2)
  176. #define  APPC_CFG_ERROR_NO_DEFAULT_LOCAL_LU     (APPC_CFG_ERROR + 1)
  177. #define  APPC_CFG_ERROR_BAD_LOCAL_LU            (APPC_CFG_ERROR + 2)
  178. #define  APPC_CFG_ERROR_GENERAL_FAILURE         (APPC_CFG_ERROR + 3)
  179. #define  APPC_CFG_ERROR_INVALID_HWND            (APPC_CFG_ERROR + 4)
  180. #define  APPC_CFG_ERROR_BAD_POINTER             (APPC_CFG_ERROR + 5)
  181. #define  APPC_CFG_ERROR_TOO_MANY_REQUESTS       (APPC_CFG_ERROR + 6)
  182. #define  APPC_CFG_ERROR_NO_APPC_INIT            (APPC_CFG_ERROR + 7)
  183. #define  APPC_CFG_ERROR_UNCLEAR_COMPLETION_MODE (APPC_CFG_ERROR + 8)
  184. #define  APPC_CFG_ERROR_BAD_PARAMETER           (APPC_CFG_ERROR + 10)
  188. /*****************************************************************************/
  189. /*                                                                           */
  190. /* HANDLE WINAPI GetAppcConfigEx( HANDLE hWnd, LPSTR pAssociate, INT CmdCode,*/
  191. /*                              LPINT pNumNames, INT iMaxNames, LPSTR pNames,*/
  192. /*                              LPINT pAsyncRetCode)                         */
  193. /*                                                                           */
  194. /* Parameters                                                                */
  195. /* ----------                                                                */
  196. /*                                                                           */
  197. /*  IN      hWnd      Handle of window to which completion is to be posted.  */
  198. /*                    If NULL no completion message will be posted but       */
  199. /*                    pAsyncRetCode must be valid. If hWnd is non-NULL it    */
  200. /*                    must be valid & pAsyncRetCode must be NULL.            */
  201. /*                                                                           */
  202. /*  IN      pAssociate Pointer to ASCII name that qualifies which names to   */
  203. /*                    retrieve. The meaning of the name depends on CmdCode.  */
  204. /*                    The name could be a Local LU,a Remote LU, a SNA        */
  205. /*                    Server, or a NULL pointer.                             */
  206. /*                    For SNA Server the syntax may be a Machine name, or    */
  207. /*                    Service name:Machine name (ex SNASRV02:THISBOX )       */
  208. /*                                                                           */
  209. /*  IN      CmdCode   Specifies what names to retrieve and what association  */
  210. /*                    to use.                                                */
  211. /*                    NAMES_LOCALFORREMOTE  get Local LU names that can      */
  212. /*                                          partner with the Remote LU name  */
  213. /*                                          that pAssociate points to.       */
  214. /*                                                                           */
  215. /*                    NAMES_LOCALFORLOCAL   get Local LU names that can      */
  216. /*                                          partner with the Local LU name   */
  217. /*                                          that pAssociate points to.       */
  218. /*                                                                           */
  219. /*                    NAMES_LOCALFORNODE    get Local LU names that          */
  220. /*                                          are defined on the SNA Server    */
  221. /*                                          that pAssociate points to.       */
  222. /*                                                                           */
  223. /*                    NAMES_LOCALFORALL     get all Local LU names that      */
  224. /*                                          are defined on the sub-domain.   */
  225. /*                                          pAssociate is ignored.           */
  226. /*                                                                           */
  227. /*                    NAMES_REMOTEFORLOCAL  get Remote LU names that can     */
  228. /*                                          partner with the Local LU name   */
  229. /*                                          that pAssociate points to.       */
  230. /*                                                                           */
  231. /*                    NAMES_REMOTEFORNODE   get Remote LU names that         */
  232. /*                                          are defined on the SNA Server    */
  233. /*                                          that pAssociate points to.       */
  234. /*                                                                           */
  235. /*                    NAMES_REMOTEFORALL    get all Remote LU names that     */
  236. /*                                          are defined on the sub-domain.   */
  237. /*                                          pAssociate is ignored.           */
  238. /*                                                                           */
  239. /*                    NAMES_MODEFORALL      get all Mode names that          */
  240. /*                                          are defined on the sub-domain.   */
  241. /*                                          pAssociate is ignored.           */
  242. /*                                                                           */
  243. /*                                                                           */
  244. /*                                                                           */
  245. /*  IN/OUT  pNumNames Pointer to int to receive the number of names          */
  246. /*                    available. (If more than MaxRemLu then only the first  */
  247. /*                    MaxRemLu of them will have been copied)                */
  248. /*                                                                           */
  249. /*  IN      iMaxNames Int giving the max number of names the                 */
  250. /*                    buffer can hold. (size of buffer in bytes / 9)         */
  251. /*                                                                           */
  252. /*  IN/OUT  pNames    Pointer to buffer to receive names.                    */
  253. /*                    The data will be returned as an array of max 8 byte    */
  254. /*                    ASCII strings each followed by a terminating NULL      */
  255. /*                                                                           */
  256. /*  IN/OUT  pAsyncRetCode                                                    */
  257. /*                    Optional pointer to int to take the RetCode on         */
  258. /*                    completion of the async part of the call. Only         */
  259. /*                    required if hWnd is NULL. If the request is not        */
  260. /*                    accepted the value in AsyncRetCode is undefined.       */
  261. /*                    It the request was accepted then until the request is  */
  262. /*                    completed AsyncRetCode will contain the value          */
  263. /*                    APPC_CFG_PENDING. Final values are as in the LPARAM of */
  264. /*                    the completion message. If hWnd != NULL, pAsyncRetCode */
  265. /*                    must be NULL.                                          */
  266. /*                                                                           */
  267. /*                                                                           */
  268. /* Returns                                                                   */
  269. /* -------                                                                   */
  270. /*                                                                           */
  271. /* On Call                                                                   */
  272. /* -------                                                                   */
  273. /*  HANDLE  This VerbId will be returned in the WPARAM of any completion     */
  274. /*          message. (VerbId & APPC_CFG_SUCCESS) evaluates to TRUE if the    */
  275. /*          request was accepted.                                            */
  276. /*                                                                           */
  277. /*          If the above expression evaluates to FALSE then VerbId will      */
  278. /*          have one of the following values:                                */
  279. /*                                                                           */
  280. /*             APPC_CFG_ERROR_NO_APPC_INIT                                   */
  281. /*             APPC_CFG_ERROR_INVALID_HWND                                   */
  282. /*             APPC_CFG_ERROR_BAD_POINTER                                    */
  283. /*             APPC_CFG_ERROR_UNCLEAR_COMPLETION_MODE                        */
  284. /*             APPC_CFG_ERROR_TOO_MANY_REQUESTS                              */
  285. /*             APPC_CFG_ERROR_GENERAL_FAILURE                                */
  286. /*                                                                           */
  287. /*                                                                           */
  288. /*                                                                           */
  289. /* On Receipt of completion message                                          */
  290. /* --------------------------------                                          */
  291. /*  MSG     Equal to return from RegisterWindowMessage with                  */
  292. /*          WIN_APPC_CFG_COMPLETION_MSG passed as message name.              */
  293. /*                                                                           */
  294. /*  WPARAM  VerbId returned on the initiating call.                          */
  295. /*                                                                           */
  296. /*  LPARAM  Retcode which will be one of the following:                      */
  297. /*                                                                           */
  298. /*             APPC_CFG_SUCCESS_NAMES                                        */
  299. /*             APPC_CFG_SUCCESS_NAMES_INCOMPLETE                             */
  300. /*                                                                           */
  301. /*             APPC_CFG_ERROR_BAD_PARAMETER                                  */
  302. /*             APPC_CFG_ERROR_GENERAL_FAILURE                                */
  303. /*                                                                           */
  304. /*  (Retcode & APPC_CFG_ERROR)   evaluates to TRUE for an error retcode      */
  305. /*  (Retcode & APPC_CFG_SUCCESS) evaluates to TRUE for a success retcode     */
  306. /*                                                                           */
  307. /*                                                                           */
  308. /*                                                                           */
  309. /* Comments                                                                  */
  310. /* --------                                                                  */
  311. /*                                                                           */
  312. /*  Completion will either be signified by the posting of a completion       */
  313. /*  message or by the change of *pAsyncRetCode to a value other than         */
  314. /*  APPC_CFG_PENDING. The latter mechanism is intended for use by console    */
  315. /*  apps with no windows or on non-Windows platforms. Completion can then    */
  316. /*  be tested by code similar to the below:                                  */
  317. /*                                                                           */
  318. /*                while (*pAsyncRetCode == APPC_CFG_PENDING)                 */
  319. /*                {                                                          */
  320. /*                  sleep(250);                                              */
  321. /*                }                                                          */
  322. /*                                                                           */
  323. /*  Note that one of hWnd & pAsyncRetCode must be NULL and the other valid.  */
  324. /*  If this isn't the case APPC_CFG_ERROR_UNCLEAR_COMPLETION_MODE will be    */
  325. /*  returned.                                                                */
  326. /*                                                                           */
  327. /*  All strings are null terminated and are NOT space padded                 */
  328. /*                                                                           */
  329. /*  If the buffer is too short, the reported number of remote LU's available */
  330. /*  MAY be GREATER than the actual number.                                   */
  331. /*                                                                           */
  332. /*  ALL MEMORY TO WHICH POINTERS ARE PASSED MUST REMAIN VALID TILL A         */
  333. /*  COMPLETION MESSAGE IS RECEIVED                                           */
  334. /*                                                                           */
  335. /*  WinAPPCStartup MUST be called first                                      */
  336. /*                                                                           */
  337. /*****************************************************************************/
  338. /*****************************************************************************/
  339. /* Entry point prototype                                                     */
  340. /*****************************************************************************/
  341. extern HANDLE WINAPI GetAppcConfigEx( HANDLE hWnd, LPSTR pAssociate, INT CmdCode,
  342.                                  LPINT pNumNames, INT iMaxNames, LPSTR pNames,
  343.                                  LPINT pAsyncRetCode);
  346. /*****************************************************************************/
  347. /* CmdCode values                                                            */
  348. /*****************************************************************************/
  349. #ifndef NAMES_LOCALFORREMOTE
  350. #define NAMES_LOCALFORREMOTE 1
  351. #define NAMES_LOCALFORLOCAL 2
  352. #define NAMES_LOCALFORNODE 3
  353. #define NAMES_LOCALFORALL 4
  354. #define NAMES_REMOTEFORLOCAL 5
  355. #define NAMES_REMOTEFORNODE 6
  356. #define NAMES_REMOTEFORALL 7
  357. #define NAMES_MODEFORALL 8
  358. #endif
  360. #ifdef __cplusplus
  361. }
  362. #endif
  364. /*****************************************************************************/
  365. /* End ifndef APPCCFG_INCLUDED                                               */
  366. /*****************************************************************************/
  367. #endif