伺服器應用程式

下列範例來自平臺軟體發展工具組 (SDK) 之 RPC\Hello 目錄中的 'Hello World'應用程式。 分散式應用程式的伺服器端會通知系統其服務可供使用。 然後，它會等候用戶端要求。 MIDL 編譯器必須與下列範例搭配使用。

視您的應用程式大小和程式碼喜好設定而定，您可以選擇在一或多個個別的檔案中實作遠端程式。 在本教學課程程式中，原始程式檔 Hellos.c 包含主伺服器常式。 Hellop.c 檔案包含遠端程式。

在個別檔案中組織遠端程式的優點是，程式可以與獨立程式連結，以偵錯程式碼，然後再轉換成分散式應用程式。 在獨立程式中執行程式之後，您可以編譯並連結包含遠端程式的來源檔案與伺服器應用程式。 如同用戶端應用程式來源檔案，伺服器應用程式來源檔案必須包含 Hello.h 標頭檔。

伺服器會呼叫 RPC 執行時間函式 RpcServerUseProtseqEp 和 RpcServerRegisterIf ，讓系結資訊可供用戶端使用。 此範例程式會將介面控制碼名稱傳遞至 RpcServerRegisterIf。 其他參數會設定為 Null。 然後伺服器會呼叫 RpcServerListen 函式，指出它正在等候用戶端要求。

伺服器應用程式也必須包含伺服器存根呼叫的兩個記憶體管理功能： midl_user_allocate 和 midl_user_free。 當遠端程式將參數傳遞至伺服器時，這些函式會在伺服器上配置和釋放記憶體。 在此範例程式中， midl_user_allocate 和 midl_user_free 只是 C 程式庫函式 malloc 和 free 的包裝函 式。 (請注意，在 MIDL 編譯器產生的正向宣告中，「MIDL」 是大寫。標頭檔 Rpcndr.h 會分別定義midl_user_free和midl_user_allocate MIDL_user_free和MIDL_user_allocate。)

/* file: hellos.c */
#include <stdlib.h>
#include <stdio.h>
#include <ctype.h>
#include "hello.h"
#include <windows.h>

void main()
{
    RPC_STATUS status;
    unsigned char * pszProtocolSequence = "ncacn_np";
    unsigned char * pszSecurity         = NULL; 
    unsigned char * pszEndpoint         = "\\pipe\\hello";
    unsigned int    cMinCalls = 1;
    unsigned int    fDontWait = FALSE;
 
    status = RpcServerUseProtseqEp(pszProtocolSequence,
                                   RPC_C_LISTEN_MAX_CALLS_DEFAULT,
                                   pszEndpoint,
                                   pszSecurity); 
 
    if (status) exit(status);
 
    status = RpcServerRegisterIf(hello_ServerIfHandle,  
                                 NULL,   
                                 NULL); 
 
    if (status) exit(status);
 
    status = RpcServerListen(cMinCalls,
                             RPC_C_LISTEN_MAX_CALLS_DEFAULT,
                             fDontWait);
 
    if (status) exit(status);
 }

/******************************************************/
/*         MIDL allocate and free                     */
/******************************************************/
 
void __RPC_FAR * __RPC_USER midl_user_allocate(size_t len)
{
    return(malloc(len));
}
 
void __RPC_USER midl_user_free(void __RPC_FAR * ptr)
{
    free(ptr);
}