Función RpcMgmtSetComTimeout (rpcdce.h)

  • Artículo

La función RpcMgmtSetComTimeout establece el valor de tiempo de espera de comunicaciones de enlace en un identificador de enlace.

Sintaxis

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

Parámetros

Binding

Identificador de enlace de servidor cuyo valor de tiempo de espera está establecido.

Timeout

Valor de tiempo de espera de comunicaciones, de cero a 10. Estos valores no son segundos; representan una cantidad de tiempo relativa en una escala de cero a 10.

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_INVALID_TIMEOUT
 El valor de tiempo de espera 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.
 

Comentarios

En Windows XP y Windows 2000, durante el enlace, el tiempo de ejecución de RPC usa el menor tiempo de espera de una llamada de 15 minutos y el tiempo de espera establecido mediante la función RpcMgmtSetComTimeout . En intercambios posteriores al enlace, el tiempo de ejecución de RPC solo usa el tiempo de espera establecido en mediante la función RpcMgmtSetComTimeout . Esta opción se omite para las secuencias de protocolo ncalrpc y ncadg_* .

Una aplicación cliente llama a RpcMgmtSetComTimeout para cambiar el valor de tiempo de espera de comunicaciones para un identificador de enlace de servidor. Dependiendo de la secuencia de protocolo para el identificador de enlace especificado, el valor de tiempo de espera solo actúa como una sugerencia para la biblioteca en tiempo de ejecución RPC. Cada secuencia de protocolo interpreta esta configuración de forma diferente; para ncacn_ip_tcp, el valor se usa para activar keep-alives para todas las llamadas. Por ejemplo, para ncacn_ip_tcp, establecer Timeout en cero indica a RPC que active keep-alives si no se recibe una respuesta en 60 segundos (el intervalo de 60 segundos es específico de la implementación y está sujeto a cambios). En esta situación, la llamada de cliente no se agota el tiempo de espera siempre que se ejecute el servidor; Sin embargo, si el servidor produce un error o pierde su dirección IP, RPC produce un error en la llamada. La sugerencia de tiempo de espera tcp se usa durante el establecimiento de la conexión, así como durante los intercambios de solicitudes y respuestas.

Nota El uso de la sugerencia de tiempo de espera de TCP es el procedimiento recomendado para detectar servidores con errores.

En Windows XP, las conexiones activas para una conexión determinada se desactivan cuando el servidor responde.

 
Para mayor comodidad, se proporcionan constantes para determinados valores en el intervalo de tiempo de espera. Para obtener una lista de los valores definidos por RPC que una aplicación puede usar para el argumento de tiempo de espera, consulte Constantes de tiempo de espera de enlace.

Requisitos

   
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

RpcMgmtInqComTimeout