我们从一个简单的 RPC “Hello, world!”的例子开始。

参考资料:MSDN: Win32 and COM Development -> Networking -> Network Protocols -> Remote Procedure Calls (RPC)

第1步:编写 IDL(Interface Description Language,接口描述语言)文件

--------------------------------------------------------------------------------

IDL 是一个通用的工业标准语言,大家应该不陌生,因为 COM 里面也是用它来描述接口的。

Hello.idl:

[

     uuid("4556509F-618A-46CF-AB3D-ED736ED66477"),   // 唯一的UUID,用 GUIDGen 生成

     version(1.0)

]

interface HelloWorld  

{

     // 我们定义的方法

     void Hello([in,string]const char * psz);

     void Shutdown(void);  

}

一个可选的文件是应用程序配置文件(.acf),它的作用是对 RPC 接口进行配置,例如下面的 Hello.acf 文件:

Hello.acf:

[  

     implicit_handle(handle_t    HelloWorld_Binding)  

]

interface HelloWorld

{

}

上面定义了 implicit_handle,这样客户端将绑定句柄 HelloWorld_Binding 了,后面的客户端代码中我们会看到。

编译 IDL 文件:

>midl Hello.idl

Microsoft (R) 32b/64b MIDL Compiler Version 6.00.0366

Copyright (c) Microsoft Corporation 1991-2002. All rights reserved.

Processing .\Hello.idl

Hello.idl

Processing .\Hello.acf

Hello.acf

我们可以看到自动生成了 Hello.h, Hello_s.c, Hello_c.c 文件,这些叫做 rpc stub 程序,不过我们可以不管这个概念,

我们只需要知道 Hello.h 里面定义了一个

extern RPC_IF_HANDLE HelloWorld_v1_0_s_ifspec;

这个 RPC_IF_HANDLE 将在后面用到。

第2步:编写服务端程序

--------------------------------------------------------------------------------

第1步中我们已经约定了调用的接口,那么现在我们开始实现其服务端。代码如下:

server.c

#include <stdlib.h>

#include <stdio.h>

#include "Hello.h"     // 引用MIDL 生成的头文件

/**

 * 这是我们在IDL 中定义的接口方法

 * 需要注意一点,IDL 里面的声明是:void Hello([in,string]const char * psz);

 * 但是这里变成了const unsigned char *,为什么呢?

 * 参见MSDN 中的MIDL Command-Line Reference -> /char Switch

 * 默认的编译选项,对 IDL 中的char 按照unsigned char 处理

 */

void Hello(const unsigned char * psz)

{

     printf("%s\n", psz);

}

/** 这也是我们在IDL 中定义的接口方法,提供关闭server 的机制*/

void Shutdown(void)

{

     // 下面的操作将导致 RpcServerListen() 退出

     RpcMgmtStopServerListening(NULL);

     RpcServerUnregisterIf(NULL, NULL, FALSE);

}

int main(int argc,char * argv[])

{

     // 用Named Pipe 作为RPC 的通道,这样EndPoint 参数就是Named Pipe 的名字

     // 按照Named Pipe 的命名规范,\pipe\pipename,其中pipename 可以是除了\ 

     // 之外的任意字符,那么这里用一个GUID 串来命名,可以保证不会重复

     RpcServerUseProtseqEp((unsigned char *)"ncacn_np", 20, (unsigned char *)"\\pipe\\{8dd50205-3108-498f-96e8-dbc4ec074cf9}",
NULL);

// 注册接口,HelloWorld_v1_0_s_ifspec 是在MIDL 生成的Hello.h 中定义的

     RpcServerRegisterIf(HelloWorld_v1_0_s_ifspec, NULL, NULL);

    

     // 开始监听,本函数将一直阻塞

     RpcServerListen(1,20,FALSE); 

     return 0;

}

// 下面的函数是为了满足链接需要而写的,没有的话会出现链接错误

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);

}

编译:

>cl /D_WIN32_WINNT=0x500 server.c Hello_s.c rpcrt4.lib

用于 80x86 的 Microsoft (R) 32 位 C/C++ 优化编译器 14.00.50727.42 版

版权所有(C) Microsoft Corporation。保留所有权利。

server.c

Hello_s.c

正在生成代码...

Microsoft (R) Incremental Linker Version 8.00.50727.42

Copyright (C) Microsoft Corporation.  All rights reserved.

/out:server.exe

server.obj

Hello_s.obj

rpcrt4.lib

编译时为什么要指定 _WIN32_WINNT=0x500 呢?因为如果没有的话会报告下面的错误:

Hello_s.c(88) : fatal error C1189: #error :  You need a Windows 2000 or later to

run this stub because it uses these features:

第3步:编写客户端程序

--------------------------------------------------------------------------------

客户端的代码:

client.c

#include <stdlib.h>

#include <stdio.h>

#include <string.h>

#include "Hello.h"     // 引用MIDL 生成的头文件

int main(int argc, char * argv[])

{

     unsigned char * pszStringBinding = NULL;

     if ( argc != 2 )

     {

         printf("Usage:%s <Hello Text>\n", argv[0]);

         return 1;

     }

// 用Named Pipe 作为RPC 的通道。参见server.c 中的RpcServerUseProtseqEp() 部分

     // 第3 个参数NetworkAddr 如果取NULL,那么就是连接本机服务

     // 否则要取\\\\servername 这样的格式,例如你的计算机名为jack,那么就是\\jack

     RpcStringBindingCompose( NULL, (unsigned char*)"ncacn_np", /*(unsigned char*)"\\\\servername"*/NULL, (unsigned char*)"\\pipe\\{8dd50205-3108-498f-96e8-dbc4ec074cf9}",
NULL, &pszStringBinding );

// 绑定接口,这里要和 Hello.acf 的配置一致,那么就是HelloWorld_Binding

     RpcBindingFromStringBinding(pszStringBinding, & HelloWorld_Binding );

// 下面是调用服务端的函数了

     RpcTryExcept

     {

         if ( _stricmp(argv[1], "SHUTDOWN") == 0 )

         {

              Shutdown();

         }

         else

         {

              Hello((unsigned char*)argv[1]);

         }

     }

     RpcExcept(1)

     {

         printf( "RPC Exception %d\n", RpcExceptionCode() );

     }

     RpcEndExcept

// 释放资源

     RpcStringFree(&pszStringBinding);

     RpcBindingFree(&HelloWorld_Binding);

     return 0;

}

// 下面的函数是为了满足链接需要而写的,没有的话会出现链接错误

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);

}

编译:

>cl /D_WIN32_WINNT=0x500 client.c Hello_c.c rpcrt4.lib

用于 80x86 的 Microsoft (R) 32 位 C/C++ 优化编译器 14.00.50727.42 版

版权所有(C) Microsoft Corporation。保留所有权利。

client.c

Hello_c.c

正在生成代码...

Microsoft (R) Incremental Linker Version 8.00.50727.42

Copyright (C) Microsoft Corporation.  All rights reserved.

/out:client.exe

client.obj

Hello_c.obj

rpcrt4.lib

第4步:测试:

--------------------------------------------------------------------------------

运行 server.exe,将弹出一个 console 窗口,等待客户端调用。

运行客户端 client.exe:

>client hello

可以看到 server.exe 的 console 窗口出现 hello 的字符串。

>client shutdown

server.exe 退出。

RPC 编程的更多相关文章

  1. RPC 编程 使用 RPC 编程是在客户机和服务器实体之间进行可靠通信的最强大、最高效的方法之一。它为在分布式计算环境中运行的几乎所有应用程序提供基础。

    RPC 编程 使用 RPC 编程是在客户机和服务器实体之间进行可靠通信的最强大.最高效的方法之一.它为在分布式计算环境中运行的几乎所有应用程序提供基础.本文介绍 RPC 客户机和服务器之间基本的事件流 ...

  2. Linux rpc 编程最简单实例

    通过rpcgen的man手册看到此工具的作用是把RPC源程序编译成C语言源程序,从而轻松实现远程过程调用.1.下面的例子程序的作用是客户端程序(fedora Linux下)取中心服务器也是Linux上 ...

  3. [golang note] 网络编程 - RPC编程

    net包 • 官方文档 http://godoc.golangtc.com/pkg/net/ Package net provides a portable interface for network ...

  4. archlinux中c语言的rpc编程

    参考:http://www.cs.rutgers.edu/~pxk/rutgers/notes/rpc/ 启动rpc服务端会出现 unable to register 这个错误,据说是要启用 port ...

  5. RPC通信编程

    使用 RPC 编程是在客户机和服务器实体之间进行可靠通信的最强大.最高效的方法之一.它为在分布式计算环境中运行的几乎所有应用程序提供基础. RPC 是什么? RPC 的全称是 Remote Proce ...

  6. RPC介绍以及编程

    1 RPC介绍 RPC(Remote Procedure Call Protocol)——远程过程调用协议,它是一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的协 议. RPC采用客 ...

  7. Windows RPC Demo实现

    Windows RPC Demo实现 本文参考并整理以下相关文章 1. <远程过程调用> -百度百科 2. <RPC 编程> -http://www.ibm.com/devel ...

  8. OD: RPC - MS06040 & MS08067

    RPC 漏洞简介 Remote Procedure Call,分布式计算中常用到的技术.两台计算机通信过程可以分为两种形式:一种是数据的交换,另一种是进程间通信.RPC 属于进程间通信. RPC 就是 ...

  9. Windows RPC

    转载 Windows RPC Demo实现 本文参考并整理以下相关文章 1. <远程过程调用> -百度百科 2. <RPC 编程> -http://www.ibm.com/de ...

随机推荐

  1. linux 7 系统查询相关

    今天 领导让我整理一下查询关于系统信息的一些命令,查找并验证了之后,我发上来给大家分享一下. 1. #uname –a显示电脑及操作系统信息2. #cat /proc/version查看正在运行的内核 ...

  2. ZMQ面面观

    ZMQ是什么? 这是个类似于Socket的一系列接口,他跟Socket的区别是:普通的socket是端到端的(1:1的关系),而ZMQ却是可以N:M 的关系,人们对BSD套接字的了解较多的是点对点的连 ...

  3. sql 左连接与右连接

    假设有A,B两个表. 表A记录如下: aID aNum 1 a20050111 2 a20050112 3 a20050113 4 a20050114 5 a20050115 表B记录如下: bID ...

  4. 基于javaweb人脸识别注册登录系统

    ---恢复内容开始--- 现在是2019年,人脸识别技术已经相当成熟了,百度自2017年发布人脸识别技术,已经被广泛应用,不管从现在的iphoneX掀起的面部解锁到手机应用端的各种人脸认证,这一技术已 ...

  5. 【Codeforces Round #429 (Div. 2) B】 Godsend

    [Link]:http://codeforces.com/contest/841/problem/B [Description] 两个人轮流对一个数组玩游戏,第一个人可以把连续的一段为奇数的拿走,第二 ...

  6. post请求传文件

    public static JSONObject doFormDataPost(File file, String sURL) throws IOException { HttpClient cont ...

  7. [JZOJ 5860] 荒诞

    思路: 头皮发麻的操作... 理解一下题意会发现:排名为\(i\)的前缀正好是第\(i\)个前缀. 所以问题就变成了求\(1->len\)的平方和,注意取模即可. #include <bi ...

  8. docker搭建jenkins

    这里是在linux环境下安装docker之后,在doucer内安装jenkins --------------------docker 安装 jenkins---------------------- ...

  9. mysql最新版与mysql5.6的兼容问题

    最近公司在给别的企业打了一个项目,在公司本地使用的是mysql 5.6,但是搭建的项目的mysql版本是最新版5.7以后吧,所以有些sql在执行上出了一点问题 目前发现的是: 1: 在5.6版本下先o ...

  10. 2019 牛客多校第一场 F Random Point in Triangle

    题目链接:https://ac.nowcoder.com/acm/contest/881/F 题目大意 给定二维平面上 3 个整数表示的点 A,B,C,在三角形 ABC 内随机选一点 P,求期望$E ...