Función RpcMgmtStopServerListening (rpcdce.h)

  • Artículo

La función RpcMgmtStopServerListening indica a un servidor que deje de escuchar llamadas a procedimientos remotos. Esta función no afectará a las interfaces de escucha automática. Consulte RpcServerRegisterIfEx para obtener más detalles.

Sintaxis

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

Parámetros

Binding

Para dirigir una aplicación remota para dejar de escuchar llamadas a procedimientos remotos, especifique un identificador de enlace de servidor para esa aplicación. Para dirigir su propia aplicación (local) para dejar de escuchar llamadas a procedimientos remotos, especifique un valor null.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_BINDING
 El identificador de enlace no era válido.
RPC_S_WRONG_KIND_OF_BINDING
 Este era el tipo incorrecto de enlace para la operación.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

Comentarios

Una aplicación llama a la función RpcMgmtStopServerListening para dirigir a un servidor para dejar de escuchar llamadas a procedimientos remotos. Si DontWait era TRUE, la aplicación debe llamar a RpcMgmtWaitServerListen para esperar a que se completen todas las llamadas.

Cuando recibe una solicitud de detención de escucha, la biblioteca en tiempo de ejecución rpc deja de aceptar nuevas llamadas a procedimientos remotos para todas las interfaces registradas. La ejecución de llamadas puede completarse, incluidas las devoluciones de llamada. Una vez completadas todas las llamadas, esta función indica a la función RpcServerListen que debe dejar de escuchar y volver al autor de la llamada. Si el parámetro DontWait de RpcServerListen se estableció en TRUE, la aplicación llama a RpcMgmtWaitServerListen para que se completen todas las llamadas restantes.

Nota Desde el lado cliente, RpcMgmtStopServerListening está deshabilitado de forma predeterminada. Para habilitar esta función, cree una función de autorización en la aplicación de servidor que devuelva TRUE (para permitir un apagado remoto) siempre que se llame a RpcMgmtStopServerListening . Use RpcMgmtSetAuthorizationFn para conceder al cliente acceso a la función de administración.
 
El servidor debe estar escuchando las llamadas a procedimientos remotos para que esta función se realice correctamente. Si el servidor no está escuchando, se produce un error en la función.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcdce.h (incluir Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx