Compartilhar via

Função RpcMgmtSetComTimeout (rpcdce.h)

  • Artigo

A função RpcMgmtSetComTimeout define o valor de tempo limite de comunicações de associação em um identificador de associação.

Sintaxe

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

Parâmetros

Binding

Identificador de associação de servidor cujo valor de tempo limite está definido.

Timeout

Valor de tempo limite de comunicações, de zero a 10. Esses valores não são segundos; eles representam uma quantidade relativa de tempo em uma escala de zero a 10.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_INVALID_TIMEOUT
 O valor de tempo limite era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse era o tipo errado de associação para a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

No Windows XP e no Windows 2000, durante a associação, o tempo de execução do RPC usa o tempo limite de chamada mais curto de 15 minutos e o tempo limite definido usando a função RpcMgmtSetComTimeout . Em trocas subsequentes à associação, o tempo de execução do RPC usa apenas o tempo limite definido em usando a função RpcMgmtSetComTimeout . Essa opção é ignorada para sequências de protocolo ncalrpc e ncadg_* .

Um aplicativo cliente chama RpcMgmtSetComTimeout para alterar o valor de tempo limite de comunicações para um identificador de associação de servidor. Dependendo da sequência de protocolo para o identificador de associação especificado, o valor de tempo limite atua apenas como uma dica para a biblioteca de tempo de execução RPC. Cada sequência de protocolo interpreta essa configuração de maneira diferente; para ncacn_ip_tcp, o valor é usado para ativar keep alives para todas as chamadas. Por exemplo, para ncacn_ip_tcp, definir Timeout como zero instrui o RPC a ativar keep alives se uma resposta não for recebida em 60 segundos (o intervalo de 60 segundos é específico da implementação e está sujeito a alterações). Nessa situação, a chamada do cliente não atingiu o tempo limite enquanto o servidor estiver em execução; no entanto, se o servidor falhar ou perder seu endereço IP, o RPC falhará na chamada. A dica de tempo limite TCP é usada durante o estabelecimento da conexão, bem como durante trocas de solicitação/resposta.

Nota Usar a dica de tempo limite TCP é a melhor prática para detectar servidores com falha.

No Windows XP, keep-alives para uma determinada conexão são desativados quando o servidor responde.

 
Para sua conveniência, as constantes são fornecidas para determinados valores no intervalo de tempo limite. Para obter uma lista dos valores definidos por RPC que um aplicativo pode usar para o argumento de tempo limite, consulte Constantes de tempo limite de associação.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcMgmtInqComTimeout