rpcMgmtStopServerListening 函数 (rpcdce.h)

RpcMgmtStopServerListening 函数告知服务器停止侦听远程过程调用。 此函数不会影响自动侦听接口。 有关更多详细信息,请参阅 RpcServerRegisterIfEx

语法

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

parameters

Binding

若要指示远程应用程序停止侦听远程过程调用,请为该应用程序指定服务器绑定句柄。 若要指示自己的 (本地) 应用程序停止侦听远程过程调用,请将值指定为 NULL

返回值

含义
RPC_S_OK
调用成功。
RPC_S_INVALID_BINDING
绑定句柄无效。
RPC_S_WRONG_KIND_OF_BINDING
这是操作的错误绑定类型。
 
注意 有关有效错误代码的列表,请参阅 RPC 返回值
 

注解

应用程序调用 RpcMgmtStopServerListening 函数以指示服务器停止侦听远程过程调用。 如果 DontWaitTRUE,则应用程序应调用 RpcMgmtWaitServerListen 以等待所有调用完成。

当它收到停止侦听请求时,RPC 运行时库将停止接受所有已注册接口的新远程过程调用。 允许执行调用完成,包括回调。 所有调用完成后,此函数会向 RpcServerListen 函数发出信号,指示它必须停止侦听并返回到调用方。 如果 RpcServerListenDontWait 参数设置为 TRUE,则应用程序将调用 RpcMgmtWaitServerListen 以完成所有剩余的调用。

注意 在客户端, RpcMgmtStopServerListening 默认处于禁用状态。 若要启用此函数,请在服务器应用程序中创建一个授权函数,该函数返回 TRUE (,以便在每次调用 RpcMgmtStopServerListening 时允许远程关闭) 。 使用 RpcMgmtSetAuthorizationFn 向客户端授予对管理功能的访问权限。
 
服务器必须侦听远程过程调用,此函数才能成功。 如果服务器未侦听,则函数将失败。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx