RNRSRV.C
上传用户:bangxh
上传日期:2007-01-31
资源大小:42235k
文件大小:21k
源码类别:

Windows编程

开发平台:

Visual C++

  1. /*++
  2. Copyright (c) 1994 Microsoft Corporation
  3. Module Name:
  4.     RnrSrv.c
  5. Abstract:
  6.     Test and demonstration service for the RNR (service Registration and
  7.     Name Resolution) APIs.  This is a simple service designed to show
  8.     the basic principles involved in using the RNR APIs to _write a
  9.     protocol-independent Windows Sockets service.
  10.     This service opens a number of listening sockets, waits for an
  11.     incoming connection from a client, accepts the connection, then
  12.     echos data back to the client until the client terminates the
  13.     virtual circuit.  This service is single-threaded and can handle
  14.     only a single client at a time.
  15.     The OpenListeners() routine implemented herein is intended to be a
  16.     demonstration of RNR functionality commonly used in
  17.     protocol-independent services.  Service writers are encouraged to
  18.     leverage this code to assist them in writing protocol-independent
  19.     services on top of the Windows Sockets API.
  20. --*/
  21. #include <stdio.h>
  22. #include <stdlib.h>
  23. #include <windows.h>
  24. #include <winsock2.h>
  25. #include <nspapi.h>
  26. WSADATA WsaData;
  27. PSTR ServiceTypeName = "EchoExample";
  28. PSTR ServiceName = "EchoServer";
  29. #define MAX_SOCKETS    20
  30. INT
  31. OpenListeners (
  32.     IN PTSTR ServiceName,
  33.     IN LPGUID ServiceType,
  34.     IN BOOL Reliable,
  35.     IN BOOL MessageOriented,
  36.     IN BOOL StreamOriented,
  37.     IN BOOL Connectionless,
  38.     OUT SOCKET SocketHandles[],
  39.     OUT INT ProtocolsUsed[]
  40.     );
  41. INT
  42. AdvertiseService(
  43.     IN PTSTR ServiceName,
  44.     IN LPGUID ServiceType,
  45.     IN SOCKET SocketHandles[],
  46.     IN INT SocketCount
  47.     );
  48. void _CRTAPI1
  49. main (
  50.     int argc,
  51.     char *argv[]
  52.     )
  53. {
  54.     INT count, err, i ;
  55.     DWORD tmpProtocol[2];
  56.     BYTE buffer[1024];
  57.     DWORD bytesRequired;
  58.     PPROTOCOL_INFO protocolInfo;
  59.     GUID serviceType;
  60.     FD_SET readfds;
  61.     SOCKET listenSockets[MAX_SOCKETS+1];
  62.     INT protocols[MAX_SOCKETS+1];
  63.     SOCKET s;
  64.     //
  65.     // Initialize the Windows Sockets DLL.
  66.     //
  67.     err = WSAStartup( 0x0202, &WsaData );
  68.     if ( err == SOCKET_ERROR )
  69.     {
  70.         printf( "WSAStartup() failed: %ldn", GetLastError( ) );
  71.         return;
  72.     }
  73.     //
  74.     // Determine the value of our GUID.  The GUID uniquely identifies
  75.     // the type of service we provide.
  76.     //
  77.     err = GetTypeByName( ServiceTypeName, &serviceType );
  78.     if ( err == SOCKET_ERROR )
  79.     {
  80.         printf( "GetTypeByName for "%s" failed: %ldn",
  81.                     ServiceTypeName, GetLastError( ) );
  82.         exit( 1 );
  83.     }
  84.     //
  85.     // Open listening sockets for this service.
  86.     //
  87.     count = OpenListeners(
  88.                 ServiceName,
  89.                 &serviceType,
  90.                 TRUE,
  91.                 FALSE,
  92.                 FALSE,
  93.                 FALSE,
  94.                 listenSockets,
  95.                 protocols
  96.                 );
  97.     if ( count <= 0 )
  98.     {
  99.         printf( "failed to open listenSockets for name "%s" type "%s"n",
  100.                     ServiceName, ServiceTypeName );
  101.         exit( 1 );
  102.     }
  103.     //
  104.     // We successfully opened some listening sockets.  Display some
  105.     // information on each protocol in use.
  106.     //
  107.     tmpProtocol[1] = 0;
  108.     for ( i = 0; i < count; i++ )
  109.     {
  110.         tmpProtocol[0] = protocols[i];
  111.         bytesRequired = sizeof(buffer);
  112.         err = EnumProtocols( tmpProtocol, buffer, &bytesRequired );
  113.         if ( err < 1 )
  114.         {
  115.             printf( "EnumProtocols failed for protocol %ld: %ldn",
  116.                         tmpProtocol[0], GetLastError( ) );
  117.             exit( 1 );
  118.         }
  119.         protocolInfo = (PPROTOCOL_INFO)buffer;
  120.         printf( "Socket %lx listening on protocol "%s" (%ld)n",
  121.                     listenSockets[i],
  122.                     protocolInfo->lpProtocol,
  123.                     protocolInfo->iProtocol );
  124.     }
  125.     //
  126.     // Advertise the service so thet it can be found.
  127.     //
  128.     printf( "Going to advertise the service.n" ) ;
  129.     err = AdvertiseService(
  130.                 ServiceName,
  131.                 &serviceType,
  132.                 listenSockets,
  133.                 count) ;
  134.     if (err == SOCKET_ERROR)
  135.     {
  136.         printf( "Failed to advertise the service. Error %dn", GetLastError()) ;
  137.         exit( 1 ) ;
  138.     }
  139.     printf( "Successfully advertised the service.n" ) ;
  140.     //
  141.     // Loop accepting connections and servicing them.
  142.     //
  143.     FD_ZERO( &readfds );
  144.     while ( TRUE )
  145.     {
  146.         //
  147.         // Add the listening sockets to the FD_SET we'll pass to select.
  148.         //
  149.         for ( i = 0; i < count; i++ )
  150.         {
  151.             FD_SET( listenSockets[i], &readfds );
  152.         }
  153.         //
  154.         // Wait for one of the listenSockets to receive an incoming connection.
  155.         //
  156.         err = select( count, &readfds, NULL, NULL, NULL );
  157.         if ( err < 1 )
  158.         {
  159.             printf( "select() returned %ld, error %ldn", err, GetLastError( ) );
  160.             exit( 1 );
  161.         }
  162.         //
  163.         // Find the socket that received an incoming connection and accept
  164.         // the connection.
  165.         //
  166.         for ( i = 0; i < count; i++ )
  167.         {
  168.             if ( FD_ISSET( listenSockets[i], &readfds ) )
  169.                 break;
  170.         }
  171.         //
  172.         // Accept the connection from the client.  We ignore the client's
  173.         // address here.
  174.         //
  175.         s = accept( listenSockets[i], NULL, NULL );
  176.         if ( s == INVALID_SOCKET )
  177.         {
  178.             printf( "accept() failed, error %ldn", GetLastError( ) );
  179.             exit( 1 );
  180.         }
  181.         printf( "Accepted incoming connection on socket %lxn",
  182.                 listenSockets[i] );
  183.         //
  184.         // Loop echoing data back to the client.  Note that this
  185.         // single-threaded service can handle only a single client at a
  186.         // time.  A more sophisticated service would service multiple
  187.         // clients simultaneously by using multiple threads or
  188.         // asynchronous I/O.
  189.         //
  190.         while ( TRUE )
  191.         {
  192.             err = recv( s, buffer, sizeof(buffer), 0 );
  193.             if ( err == 0 )
  194.             {
  195.                 printf( "Connection terminated gracefully.n" );
  196.                 break;
  197.             }
  198.             else if ( err < 0 )
  199.             {
  200.                 err = GetLastError();
  201.                 if ( err == WSAEDISCON )
  202.                 {
  203.                     printf( "Connection disconnected.n" );
  204.                 }
  205.                 else
  206.                 {
  207.                     printf( "recv() failed, error %ld.n", err );
  208.                 }
  209.                 break;
  210.             }
  211.             err = send( s, buffer, err, 0 );
  212.             if ( err < 0 )
  213.             {
  214.                 printf( "send() failed, error %ldn", GetLastError( ) );
  215.                 break;
  216.             }
  217.         }
  218.         //
  219.         // Close the connected socket and continue accepting connections.
  220.         //
  221.         closesocket( s );
  222.     }
  223. } // main
  224. INT
  225. OpenListeners (
  226.     IN PTSTR ServiceName,
  227.     IN LPGUID ServiceType,
  228.     IN BOOL Reliable,
  229.     IN BOOL MessageOriented,
  230.     IN BOOL StreamOriented,
  231.     IN BOOL Connectionless,
  232.     OUT SOCKET SocketHandles[],
  233.     OUT INT ProtocolsUsed[]
  234.     )
  235. /*++
  236. Routine Description:
  237.     Examines the Windows Sockets transport protocols loaded on a machine
  238.     and opens listening sockets on all the protocols which support the
  239.     characteristics requested by the caller.
  240. Arguments:
  241.     ServiceName - a friendly name which identifies this service.  On
  242.         name spaces which support name resolution at the service level
  243.         (e.g.  SAP) this is the name clients will use to connect to this
  244.         service.  On name spaces which support name resolution at the
  245.         host level (e.g.  DNS) this name is ignored and applications
  246.         must use the host name to establish communication with this
  247.         service.
  248.     ServiceType - the GUID value which uniquely identifies the type of
  249.         service we provide.  A GUID is created with the UUIDGEN program.
  250.     Reliable - if TRUE, the caller requests that only transport protocols
  251.         which support reliable data delivery be used.  If FALSE, both
  252.         reliable and unreliable protocols may be used.
  253.     MessageOriented - if TRUE, only message-oriented transport protocols
  254.         should be used.  If FALSE, the caller either does not care
  255.         whether the protocols used are message oriented or desires only
  256.         stream-oriented protocols.
  257.     StreamOriented - if TRUE, only stream-oriented transport protocols
  258.         should be used.  If FALSE, the caller either does not care
  259.         whether the protocols used are stream oriented or desires only
  260.         message-oriented protocols.
  261.     Connectionless - if TRUE, only connectionless protocols should be
  262.         used.  If FALSE, both connection-oriented and connectionless
  263.         protocols may be used.
  264.     SocketHandles - an array of size MAX_SOCKETS which receives listening
  265.         socket handles.
  266.     ProtocolsUsed - an array of size MAX_SOCKETS which receives the
  267.         protocol values for each of the socket handles in the
  268.         SocketHandles array.
  269. Return Value:
  270.     The count of listening sockets successfully opened, or -1 if no
  271.     sockets could be successfully opened that met the desired
  272.     characteristics.
  273. --*/
  274. {
  275.     INT            protocols[MAX_SOCKETS+1];
  276.     BYTE           buffer[2048];
  277.     DWORD          bytesRequired;
  278.     INT            err;
  279.     PPROTOCOL_INFO protocolInfo;
  280.     PCSADDR_INFO   csaddrInfo;
  281.     INT            protocolCount;
  282.     INT            addressCount;
  283.     INT            i;
  284.     DWORD          protocolIndex;
  285.     SOCKET         s;
  286.     DWORD          index = 0;
  287.     //
  288.     // First look up the protocols installed on this machine.  The
  289.     // EnumProtocols() API returns about all the Windows Sockets
  290.     // protocols loaded on this machine, and we'll use this information
  291.     // to identify the protocols which provide the necessary semantics.
  292.     //
  293.     bytesRequired = sizeof(buffer);
  294.     err = EnumProtocols( NULL, buffer, &bytesRequired );
  295.     if ( err <= 0 )
  296.     {
  297.         return 0;
  298.     }
  299.     //
  300.     // Walk through the available protocols and pick out the ones which
  301.     // support the desired characteristics.
  302.     //
  303.     protocolCount = err;
  304.     protocolInfo = (PPROTOCOL_INFO)buffer;
  305.     for ( i = 0, protocolIndex = 0;
  306.           i < protocolCount && protocolIndex < MAX_SOCKETS;
  307.           i++, protocolInfo++ )
  308.     {
  309.         //
  310.         // If "reliable" support is requested, then check if supported
  311.         // by this protocol.  Reliable support means that the protocol
  312.         // guarantees delivery of data in the order in which it is sent.
  313.         // Note that we assume here that if the caller requested reliable
  314.         // service then they do not want a connectionless protocol.
  315.         //
  316.         if ( Reliable )
  317.         {
  318.             //
  319.             // Check to see if the protocol is reliable.  It must
  320.             // guarantee both delivery of all data and the order in
  321.             // which the data arrives.  Also, it must not be a
  322.             // connectionless protocol.
  323.             //
  324.             if ( (protocolInfo->dwServiceFlags &
  325.                       XP_GUARANTEED_DELIVERY) == 0 ||
  326.                  (protocolInfo->dwServiceFlags &
  327.                       XP_GUARANTEED_ORDER) == 0 )
  328.             {
  329.                 continue;
  330.             }
  331.             if ( (protocolInfo->dwServiceFlags & XP_CONNECTIONLESS) != 0 )
  332.             {
  333.                 continue;
  334.             }
  335.             //
  336.             // Check to see that the protocol matches the stream/message
  337.             // characteristics requested.  A stream oriented protocol
  338.             // either has the XP_MESSAGE_ORIENTED bit turned off, or
  339.             // else supports "pseudo stream" capability.  Pseudo stream
  340.             // means that although the underlying protocol is message
  341.             // oriented, the application may open a socket of type
  342.             // SOCK_STREAM and the protocol will hide message boundaries
  343.             // from the application.
  344.             //
  345.             if ( StreamOriented &&
  346.                  (protocolInfo->dwServiceFlags & XP_MESSAGE_ORIENTED) != 0 &&
  347.                  (protocolInfo->dwServiceFlags & XP_PSEUDO_STREAM) == 0 )
  348.             {
  349.                 continue;
  350.             }
  351.             if ( MessageOriented &&
  352.                  (protocolInfo->dwServiceFlags & XP_MESSAGE_ORIENTED) == 0 )
  353.             {
  354.                 continue;
  355.             }
  356.         }
  357.         else if ( Connectionless )
  358.         {
  359.             //
  360.             // Make sure that this is a connectionless protocol.  In a
  361.             // connectionless protocol, data is sent as discrete
  362.             // datagrams with no connection establishment required.
  363.             // Connectionless protocols typically have no reliability
  364.             // guarantees.
  365.             //
  366.             if ( (protocolInfo->dwServiceFlags & XP_CONNECTIONLESS) != 0 )
  367.             {
  368.                 continue;
  369.             }
  370.         }
  371.         //
  372.         // This protocol fits all the criteria.  Add it to the list of
  373.         // protocols in which we're interested.
  374.         //
  375.         protocols[protocolIndex++] = protocolInfo->iProtocol;
  376.     }
  377.     //
  378.     // Make sure that we found at least one acceptable protocol.  If
  379.     // there no protocols on this machine which meet the caller's
  380.     // requirements then fail here.
  381.     //
  382.     if ( protocolIndex == 0 )
  383.     {
  384.         return 0;
  385.     }
  386.     protocols[protocolIndex] = 0;
  387.     //
  388.     // Now attempt to find the socket addresses to which we need to
  389.     // bind.  Note that we restrict the scope of the search to those
  390.     // protocols of interest by passing the protocol array we generated
  391.     // above to GetAddressByName().  This forces GetAddressByName() to
  392.     // return socket addresses for only the protocols we specify,
  393.     // ignoring possible addresses for protocols we cannot support
  394.     // because of the caller's constraints.
  395.     //
  396.     bytesRequired = sizeof(buffer);
  397.     err = GetAddressByName(
  398.                NS_DEFAULT,
  399.                ServiceType,
  400.                ServiceName,
  401.                protocols,
  402.                RES_SERVICE | RES_FIND_MULTIPLE,
  403.                NULL,                     // lpServiceAsyncInfo
  404.                buffer,
  405.                &bytesRequired,
  406.                NULL,                     // lpAliasBuffer
  407.                NULL                      // lpdwAliasBufferLength
  408.                );
  409.     if ( err <= 0 )
  410.     {
  411.         return 0;
  412.     }
  413.     //
  414.     // For each address, open a socket and attempt to listen. Note
  415.     // that if anything fails for a particular protocol we just skip on
  416.     // to the next protocol. As long as we can successfully listen on
  417.     // one protocol we are satisfied here.
  418.     //
  419.     addressCount = err;
  420.     csaddrInfo = (PCSADDR_INFO)buffer;
  421.     for ( i = 0; i < addressCount; i++, csaddrInfo++ )
  422.     {
  423.         //
  424.         // Open the socket. Note that we manually specify stream type
  425.         // if so requested in case the protocol is natively a message
  426.         // protocol but supports stream semantics.
  427.         //
  428.         s = socket( csaddrInfo->LocalAddr.lpSockaddr->sa_family,
  429.                     StreamOriented ? SOCK_STREAM : csaddrInfo->iSocketType,
  430.                     csaddrInfo->iProtocol );
  431.         if ( s == INVALID_SOCKET )
  432.         {
  433.             continue;
  434.         }
  435.         //
  436.         // Bind the socket to the local address specified.
  437.         //
  438.         err = bind( s, csaddrInfo->LocalAddr.lpSockaddr,
  439.                     csaddrInfo->LocalAddr.iSockaddrLength );
  440.         if ( err != NO_ERROR )
  441.         {
  442.             closesocket( s );
  443.             continue;
  444.         }
  445.         //
  446.         // Start listening for incoming sockets on the socket if this is
  447.         // not a datagram socket.  If this is a datagram socket, then
  448.         // the listen() API doesn't make sense; doing a bind() is
  449.         // sufficient to listen for incoming datagrams on a
  450.         // connectionless protocol.
  451.         //
  452.         if ( csaddrInfo->iSocketType != SOCK_DGRAM )
  453.         {
  454.             err = listen( s, 5 );
  455.             if ( err != NO_ERROR )
  456.             {
  457.                 closesocket( s );
  458.                 continue;
  459.             }
  460.         }
  461.         //
  462.         // The socket was successfully opened and we're listening on it.
  463.         // Remember the protocol used and the socket handle and continue
  464.         // listening on other protocols.
  465.         //
  466.         ProtocolsUsed[index] = csaddrInfo->iProtocol;
  467.         SocketHandles[index] = s;
  468.         index++;
  469.         if ( index == MAX_SOCKETS )
  470.         {
  471.             return index;
  472.         }
  473.     }
  474.     (void) LocalFree( (HLOCAL) csaddrInfo );
  475.     //
  476.     // Return the count of sockets that we're sucecssfully listening on.
  477.     //
  478.     return index;
  479. } // OpenListeners
  480. INT
  481. AdvertiseService(
  482.     IN PTSTR ServiceName,
  483.     IN LPGUID ServiceType,
  484.     IN SOCKET SocketHandles[],
  485.     IN INT SocketCount
  486.     )
  487. /*++
  488. Routine Description:
  489.     Advertises this service on all the default name spaces.
  490. Arguments:
  491.     ServiceName - the name of the service.
  492.     ServiceType - the GUID value which uniquely the service.
  493.     SocketHandles - array of sockets that we have opened. For each socket,
  494.         we do a getsockname() to discover the actual local address.
  495.     SocketCount - number of sockets in SockHandles[]
  496. Return Value:
  497.     0 if success. SOCK_ERROR otherwise.
  498. --*/
  499. {
  500.     WSAVERSION          Version;
  501.     WSAQUERYSET         QuerySet;
  502.     LPCSADDR_INFO       lpCSAddrInfo;
  503.     PSOCKADDR           sockAddr ;
  504.     BYTE *              addressBuffer;
  505.     DWORD               addressBufferSize ;
  506.     DWORD               successCount = 0 ;
  507.     INT                 i, err ;
  508.     //
  509.     // Allocate some memory for the CSADDR_INFO structures.
  510.     //
  511.     lpCSAddrInfo = (LPCSADDR_INFO) malloc( sizeof(CSADDR_INFO) * SocketCount );
  512.     if (!lpCSAddrInfo)
  513.     {
  514.         SetLastError(ERROR_NOT_ENOUGH_MEMORY) ;
  515.         return SOCKET_ERROR ;
  516.     }
  517.     //
  518.     // Allocate some memory for the SOCKADDR addresses returned
  519.     // by getsockname().
  520.     //
  521.     addressBufferSize = SocketCount * sizeof(SOCKADDR);
  522.     addressBuffer = malloc( addressBufferSize ) ;
  523.     if (!addressBuffer)
  524.     {
  525.         free(lpCSAddrInfo) ;
  526.         SetLastError(ERROR_NOT_ENOUGH_MEMORY) ;
  527.         return SOCKET_ERROR ;
  528.     }
  529.     RtlZeroMemory( &QuerySet, sizeof( WSAQUERYSET ) );
  530.     //
  531.     // For each socket, get its local association.
  532.     //
  533.     sockAddr = (PSOCKADDR) addressBuffer ;
  534.     for (i = 0; i < SocketCount; i++)
  535.     {
  536.         int size = (int) addressBufferSize ;
  537.         //
  538.         // Call getsockname() to get the local association for the socket.
  539.         //
  540.         err = getsockname(
  541.                   SocketHandles[i],
  542.                   sockAddr,
  543.                   &size) ;
  544.         if (err == SOCKET_ERROR)
  545.         {
  546.             continue ;
  547.         }
  548.         //
  549.         // Now setup the Addressing information for this socket.
  550.         // Only the dwAddressType, dwAddressLength and lpAddress
  551.         // is of any interest in this example.
  552.         //
  553.         lpCSAddrInfo[i].LocalAddr.iSockaddrLength = size;
  554.         lpCSAddrInfo[i].LocalAddr.lpSockaddr = sockAddr;
  555.         lpCSAddrInfo[i].RemoteAddr.iSockaddrLength = size;
  556.         lpCSAddrInfo[i].RemoteAddr.lpSockaddr = sockAddr;
  557.         lpCSAddrInfo[i].iSocketType = SOCK_RDM; // Reliable
  558.         lpCSAddrInfo[i].iProtocol = sockAddr->sa_family;
  559.         //
  560.         // Advance pointer and adjust buffer size. Assumes that
  561.         // the structures are aligned.
  562.         //
  563.         addressBufferSize -= size ;
  564.         sockAddr = (PSOCKADDR) ((BYTE*)sockAddr + size)  ;
  565.         successCount++ ;
  566.     }
  567.     //
  568.     // If we got at least one address, go ahead and advertise it.
  569.     //
  570.     if (successCount)
  571.     {
  572.         QuerySet.dwSize = sizeof( WSAQUERYSET );
  573.         QuerySet.lpServiceClassId = ServiceType;
  574.         QuerySet.lpszServiceInstanceName = ServiceName;
  575.         QuerySet.lpszComment = "D/C/M's Example Echo Service";
  576.         QuerySet.lpVersion = &Version;
  577.         QuerySet.lpVersion->dwVersion = 1;
  578.         QuerySet.lpVersion->ecHow = COMP_NOTLESS;
  579.         QuerySet.dwNameSpace = NS_ALL;
  580.         QuerySet.dwNumberOfCsAddrs = successCount;
  581.         QuerySet.lpcsaBuffer = lpCSAddrInfo;
  582.         err = WSASetService( &QuerySet,
  583.                              RNRSERVICE_REGISTER,
  584.                              SERVICE_MULTIPLE );
  585.         if ( err )
  586.             err = SOCKET_ERROR;
  587.     }
  588.     else
  589.         err = SOCKET_ERROR ;
  590.     free (addressBuffer) ;
  591.     return (err) ;
  592. }