--- mstools/samples/rpc/hello/hellos.c	2018/08/09 18:20:55	1.1.1.1
+++ mstools/samples/rpc/hello/hellos.c	2018/08/09 18:24:13	1.1.1.3
@@ -1,116 +1,142 @@
 /****************************************************************************
-			  Microsoft RPC Version 1.0
-			 Copyright Microsoft Corp. 1992
-				Hello Example
-
-    FILE:	hellos.c
-    USAGE:	hellos
-    PURPOSE:	Server side of RPC distributed application hello
+              Microsoft RPC Version 1.0
+             Copyright Microsoft Corp. 1992
+                hello Example
+
+    FILE:       hellos.c
+    
+    USAGE:      hellos  -p protocol_sequence
+                        -e endpoint
+                        -m max calls
+                        -n min calls
+                        -f flag for RpcServerListen
+
+    PURPOSE:    Server side of RPC distributed application hello
+    
     FUNCTIONS:  main() - registers server as RPC server
-    COMMENTS:
-    This distributed application prints "hello, world" on the server.
-    This version features a client that manages its connection to
-    the server. It uses the binding handle hello_IfHandle that is defined
-    in the generated header file hello.h.
+
+    COMMENTS:   This version of the distributed application that prints
+                "hello, world" (or other string) on the server features 
+                a client that manages its connection to the server. 
+                It uses the binding handle hello_IfHandle, defined in 
+                the file hello.h.
+
 ****************************************************************************/
+
 #include <stdlib.h>
-#include <windows.h>
-#include <string.h>
 #include <stdio.h>
 #include <ctype.h>
-#include <rpc.h>    // RPC data structures and APIs
-#include "hello.h"    // header file generated by MIDL compiler
+#include "hello.h"    // header file generated by MIDL compiler 
+
+#define PURPOSE \
+"This Microsoft RPC Version 1.0 sample program demonstrates\n\
+the use of the [string] attribute. For more information\n\
+about the attributes and the RPC API functions, see the\n\
+RPC programming guide and reference.\n\n"
 
 void Usage(char * pszProgramName)
 {
+    fprintf(stderr, "%s", PURPOSE);
     fprintf(stderr, "Usage:  %s\n", pszProgramName);
     fprintf(stderr, " -p protocol_sequence\n");
-    fprintf(stderr, " -n network_address\n");
     fprintf(stderr, " -e endpoint\n");
-    fprintf(stderr, " -o options\n");
-    fprintf(stderr, " -u uuid\n");
+    fprintf(stderr, " -m maxcalls\n");
+    fprintf(stderr, " -n mincalls\n");
+    fprintf(stderr, " -f flag_wait_op\n");
     exit(1);
 }
 
-void main(int argc, char * argv[])
+/* main:  register the interface, start listening for clients */
+void _CRTAPI1 main(int argc, char * argv[])
 {
     RPC_STATUS status;
-    unsigned char * pszUuid = "12345678-1234-1234-1234-123456789ABC";
     unsigned char * pszProtocolSequence = "ncacn_np";
-    unsigned char * pszNetworkAddress   = NULL;
-    unsigned char * pszEndpoint 	= "\\pipe\\hello";
-    unsigned char * pszOptions          = NULL;
-    unsigned char * pszStringBinding    = NULL;
+    unsigned char * pszSecurity         = NULL;
+    unsigned char * pszEndpoint         = "\\pipe\\hello";
+    unsigned int    cMinCalls           = 1;
+    unsigned int    cMaxCalls           = 20;
+    unsigned int    fDontWait           = FALSE;
     int i;
 
-    // allow the user to override settings with command line switches
+    /* allow the user to override settings with command line switches */
     for (i = 1; i < argc; i++) {
-	if ((*argv[i] == '-') || (*argv[i] == '/')) {
-	    switch (tolower(*(argv[i]+1))) {
-		case 'p':  // protocol sequence
-		    pszProtocolSequence = argv[++i];
-		    break;
-		case 'n':  // network address
-		    pszNetworkAddress = argv[++i];
-		    break;
-		case 'e':
-		    pszEndpoint = argv[++i];
-		    break;
-		case 'o':
-		    pszOptions = argv[++i];
-		    break;
-		case 'u':
-		    pszUuid = argv[++i];
-		    break;
-		case 'h':
-		case '?':
-		default:
-		    Usage(argv[0]);
-	    }
-	}
-	else
-	    Usage(argv[0]);
+        if ((*argv[i] == '-') || (*argv[i] == '/')) {
+            switch (tolower(*(argv[i]+1))) {
+            case 'p':  // protocol sequence 
+                pszProtocolSequence = argv[++i];
+                break;
+            case 'e':
+                pszEndpoint = argv[++i];
+                break;
+            case 'm':
+                cMaxCalls = (unsigned int) atoi(argv[++i]);
+                break;
+            case 'n':
+                cMinCalls = (unsigned int) atoi(argv[++i]);
+                break;
+            case 'f':
+                fDontWait = (unsigned int) atoi(argv[++i]);
+                break;
+            case 'h':
+            case '?':
+            default:
+                Usage(argv[0]);
+            }
+        }
+        else
+            Usage(argv[0]);
     }
 
     status = RpcServerUseProtseqEp(pszProtocolSequence,
-                                   1, // maximum concurrent calls
+                                   cMaxCalls,   
                                    pszEndpoint,
-				   0);
+                                   pszSecurity);  // Security descriptor
     printf("RpcServerUseProtseqEp returned 0x%x\n", status);
     if (status) {
-        exit(2);
+        exit(status);
     }
 
-    status = RpcServerRegisterIf(hello_ServerIfHandle, 0, 0);
+    status = RpcServerRegisterIf(hello_ServerIfHandle,  // interface to register
+                                 NULL,   // MgrTypeUuid
+                                 NULL);  // MgrEpv; null means use default
     printf("RpcServerRegisterIf returned 0x%x\n", status);
     if (status) {
-        exit(2);
+        exit(status);
     }
 
     printf("Calling RpcServerListen\n");
-    status = RpcServerListen(1,
-			     12345);
+    status = RpcServerListen(cMinCalls,
+                             cMaxCalls,
+                             fDontWait);
     printf("RpcServerListen returned: 0x%x\n", status);
     if (status) {
-        exit(2);
+        exit(status);
+    }
+
+    if (fDontWait) {
+        printf("Calling RpcMgmtWaitServerListen\n");
+        status = RpcMgmtWaitServerListen();  // wait operation
+        printf("RpcMgmtWaitServerListen returned: 0x%x\n", status);
+        if (status) {
+            exit(status);
+        }
     }
 
-} /* end main() */
+}  // end main()
 
-// ====================================================================
-//                MIDL allocate and free
-// ====================================================================
 
+/*********************************************************************/
+/*                MIDL allocate and free                             */
+/*********************************************************************/
 
-void * MIDL_user_allocate(size_t len)
+void __RPC_FAR * __RPC_API midl_user_allocate(size_t len)
 {
     return(malloc(len));
 }
 
-void MIDL_user_free(void * ptr)
+void __RPC_API midl_user_free(void __RPC_FAR * ptr)
 {
     free(ptr);
 }
 
-/* end hellos.c */
-
+/* end file hellos.c */