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 函数以指示服务器停止侦听远程过程调用。 如果 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

请参阅

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx