Función RpcMgmtIsServerListening (rpcdce.h)

  • Artículo

La función RpcMgmtIsServerListening indica si un servidor está escuchando llamadas a procedimientos remotos.

Sintaxis

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

Parámetros

Binding

Para determinar si una aplicación remota escucha llamadas a procedimientos remotos, especifique un identificador de enlace de servidor para esa aplicación. Para determinar si su propia aplicación (local) escucha llamadas a procedimiento remoto, especifique un valor null.

Valor devuelto

Valor Significado
RPC_S_OK
 Servidor que escucha las llamadas a procedimientos remotos.
RPC_S_NOT_LISTENING
 El servidor no escucha las llamadas a procedimientos remotos o la interfaz está escuchando automáticamente.
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, vea Rpc Return Values.
 
 

La función RpcMgmtIsServerListening devuelve resultados correctos solo para las interfaces que no escuchan automáticamente. Si la aplicación de servidor está escuchando automáticamente y llama a la función RpcMgmtIsServerListening , RpcMgmtIsServerListening devuelve RPC_SERVER_NOT_LISTENING, pero el servidor puede estar escuchando y las llamadas RPC posteriores pueden realizarse correctamente.

Comentarios

Una aplicación llama a la función RpcMgmtIsServerListening para determinar si el servidor especificado en el parámetro Binding está escuchando llamadas a procedimientos remotos.

La función RpcMgmtIsServerListening devuelve un valor de RPC_S_OK si el servidor ha llamado RpcServerListen.

El servidor debe escuchar las llamadas a procedimiento remoto para que esta función se realice correctamente. Si el servidor no está escuchando, se produce un error en la función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcEpResolveBinding

RpcServerListen