Annotation of mstools/samples/rpc/hello/helloc.c, revision 1.1.1.1

1.1       root        1: /****************************************************************************
                      2:                          Microsoft RPC Version 1.0
                      3:                        Copyright Microsoft Corp. 1992
                      4:                               Hello Example
                      5: 
                      6:     FILE:      helloc.c
                      7:     USAGE:     client   -n network_address
                      8:                         -p protocol_sequence
                      9:                         -e endpoint
                     10:                         -o options
                     11:                         -u uuid
                     12: 
                     13:     PURPOSE:   Client side of RPC distributed application
                     14:     FUNCTIONS: main() - binds to server and calls remote procedure
                     15:     COMMENTS:
                     16:     This distributed application prints a string such as "hello, world"
                     17:     on the server. The client manages its connection to the server.
                     18:     The client uses the binding handle hello_IfHandle defined in the
                     19:     file hello.h.
                     20: 
                     21: ****************************************************************************/
                     22: #include <stdio.h>
                     23: #include <string.h>
                     24: #include <stdlib.h>
                     25: #include <rpc.h>       // RPC API functions, types
                     26: #include "hello.h"     // header file generated by MIDL compiler
                     27: 
                     28: void Usage(char * pszProgramName)
                     29: {
                     30:     fprintf(stderr, "Usage:  %s\n", pszProgramName);
                     31:     fprintf(stderr, " -p protocol_sequence\n");
                     32:     fprintf(stderr, " -n network_address\n");
                     33:     fprintf(stderr, " -e endpoint\n");
                     34:     fprintf(stderr, " -o options\n");
                     35:     fprintf(stderr, " -u uuid\n");
                     36:     fprintf(stderr, " -s string\n");
                     37:     exit(1);
                     38: }
                     39: 
                     40: void main(int argc, char **argv)
                     41: {
                     42:     RPC_STATUS status;             // returned by RPC API function
                     43:     unsigned char * pszUuid = "12345678-1234-1234-1234-123456789ABC";
                     44:     unsigned char * pszProtocolSequence = "ncacn_np";
                     45:     unsigned char * pszNetworkAddress   = NULL;
                     46:     unsigned char * pszEndpoint        = "\\pipe\\hello";
                     47:     unsigned char * pszOptions          = NULL;
                     48:     unsigned char * pszStringBinding   = NULL;
                     49:     unsigned char * pszString          = "hello, world";
                     50:     int i;
                     51: 
                     52:     // allow the user to override settings with command line switches
                     53:     for (i = 1; i < argc; i++) {
                     54:        if ((*argv[i] == '-') || (*argv[i] == '/')) {
                     55:            switch (tolower(*(argv[i]+1))) {
                     56:                case 'p':  // protocol sequence
                     57:                    pszProtocolSequence = argv[++i];
                     58:                    break;
                     59:                case 'n':  // network address
                     60:                    pszNetworkAddress = argv[++i];
                     61:                    break;
                     62:                case 'e':
                     63:                    pszEndpoint = argv[++i];
                     64:                    break;
                     65:                case 'o':
                     66:                    pszOptions = argv[++i];
                     67:                    break;
                     68:                case 'u':
                     69:                    pszUuid = argv[++i];
                     70:                    break;
                     71:                case 's':
                     72:                    pszString = argv[++i];
                     73:                    break;
                     74:                case 'h':
                     75:                case '?':
                     76:                default:
                     77:                    Usage(argv[0]);
                     78:            }
                     79:        }
                     80:        else
                     81:            Usage(argv[0]);
                     82:     }
                     83: /* Use a convenience function to concatenate the elements of  */
                     84: /* the string binding into the proper sequence.              */
                     85: 
                     86:     status = RpcStringBindingCompose(pszUuid,
                     87:                                      pszProtocolSequence,
                     88:                                      pszNetworkAddress,
                     89:                                      pszEndpoint,
                     90:                                      pszOptions,
                     91:                                      &pszStringBinding);
                     92:     printf("RpcStringBindingCompose returned 0x%x\n", status);
                     93:     printf("pszStringBinding = %s\n", pszStringBinding);
                     94:     if (status)
                     95:        exit(2);
                     96: 
                     97: /* Set the binding handle that will be used to bind to the server. */
                     98: 
                     99:     status = RpcBindingFromStringBinding(pszStringBinding,
                    100:                                         &hello_IfHandle);
                    101:     printf("RpcBindingFromStringBinding returned 0x%x\n", status);
                    102:     if (status)
                    103:         exit(2);
                    104: 
                    105:     printf("Calling the remote procedure 'HelloProc'\n");
                    106:     printf("  print the string '%s' on the server\n", pszString);
                    107: 
                    108:     RpcTryExcept {
                    109:        HelloProc(pszString);  /* make call with user message */
                    110:        printf("Calling the remote procedure 'Shutdown'\n");
                    111:        Shutdown();                  // shut down the server side
                    112:     }
                    113:     RpcExcept(1) {
                    114:        printf("Runtime library reported an exception\n");
                    115:     }
                    116:     RpcEndExcept
                    117: 
                    118: /*  The calls to the remote procedures are complete. */
                    119: /*  Free the string and the binding handle          */
                    120: 
                    121:     status = RpcStringFree(&pszStringBinding); // remote calls done; unbind
                    122:     printf("RpcStringFree returned 0x%x\n", status);
                    123:     if (status)
                    124:        exit(2);
                    125: 
                    126:     status = RpcBindingFree(&hello_IfHandle);  // remote calls done; unbind
                    127:     printf("RpcBindingFree returned 0x%x\n", status);
                    128:     if (status)
                    129:        exit(2);
                    130: 
                    131: 
                    132:     exit(0);
                    133: 
                    134: }
                    135: 
                    136: // ====================================================================
                    137: //                MIDL allocate and free
                    138: // ====================================================================
                    139: 
                    140: 
                    141: void * MIDL_user_allocate(size_t len)
                    142: {
                    143:     return(malloc(len));
                    144: }
                    145: 
                    146: void MIDL_user_free(void * ptr)
                    147: {
                    148:     free(ptr);
                    149: }
                    150: 
                    151: /* end file helloc.c */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.