rpcMgmtStopServerListening 函数 (rpcdce.h)
RpcMgmtStopServerListening 函数告知服务器停止侦听远程过程调用。 此函数不会影响自动侦听接口。 有关更多详细信息,请参阅 RpcServerRegisterIfEx 。
语法
RPC_STATUS RpcMgmtStopServerListening(
RPC_BINDING_HANDLE Binding
);
parameters
Binding
若要指示远程应用程序停止侦听远程过程调用,请为该应用程序指定服务器绑定句柄。 若要指示自己的 (本地) 应用程序停止侦听远程过程调用,请将值指定为 NULL。
返回值
值 | 含义 |
---|---|
|
调用成功。 |
|
绑定句柄无效。 |
|
这是操作的错误绑定类型。 |
注意 有关有效错误代码的列表,请参阅 RPC 返回值。
注解
应用程序调用 RpcMgmtStopServerListening 函数以指示服务器停止侦听远程过程调用。 如果 DontWait 为 TRUE,则应用程序应调用 RpcMgmtWaitServerListen 以等待所有调用完成。
当它收到停止侦听请求时,RPC 运行时库将停止接受所有已注册接口的新远程过程调用。 允许执行调用完成,包括回调。 所有调用完成后,此函数会向 RpcServerListen 函数发出信号,指示它必须停止侦听并返回到调用方。 如果 RpcServerListen 的 DontWait 参数设置为 TRUE,则应用程序将调用 RpcMgmtWaitServerListen 以完成所有剩余的调用。
注意 在客户端, RpcMgmtStopServerListening 默认处于禁用状态。 若要启用此函数,请在服务器应用程序中创建一个授权函数,该函数返回 TRUE (,以便在每次调用 RpcMgmtStopServerListening 时允许远程关闭) 。 使用 RpcMgmtSetAuthorizationFn 向客户端授予对管理功能的访问权限。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | rpcdce.h (包括 Rpc.h) |
Library | Rpcrt4.lib |
DLL | Rpcrt4.dll |