Función RpcMgmtStopServerListening (rpcdce.h)

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