Функция RpcMgmtSetComTimeout (rpcdce.h)

Статья
08/25/2023

Функция RpcMgmtSetComTimeout задает значение времени ожидания binding-communications в дескрипторе привязки.

Синтаксис

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

Параметры

Binding

Дескриптор привязки сервера, для которого задано значение времени ожидания.

Timeout

Значение времени ожидания связи, от нуля до 10. Эти значения не являются секундами; они представляют относительное количество времени по шкале от нуля до 10.

Возвращаемое значение

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_BINDING	Недопустимый дескриптор привязки.
RPC_S_INVALID_TIMEOUT	Недопустимое значение времени ожидания.
RPC_S_WRONG_KIND_OF_BINDING	Это был неправильный тип привязки для операции.

Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.

В Windows XP и Windows 2000 во время привязки время выполнения RPC использует более короткое время ожидания вызова в 15 минут, а время ожидания — с помощью функции RpcMgmtSetComTimeout . При обмене после привязки время выполнения RPC использует только время ожидания, заданное в с помощью функции RpcMgmtSetComTimeout . Этот параметр не учитывается для последовательностей протоколов ncalrpc и ncadg_* .

Клиентское приложение вызывает RpcMgmtSetComTimeout , чтобы изменить значение времени ожидания связи для дескриптора привязки сервера. В зависимости от последовательности протокола для указанного дескриптора привязки значение времени ожидания действует только как указание для библиотеки времени выполнения RPC. Каждая последовательность протоколов интерпретирует этот параметр по-разному; для ncacn_ip_tcp значение используется для включения активности для всех вызовов. Например, для ncacn_ip_tcp значение параметра Timeout равным нулю позволяет RPC включить функцию поддержания активности, если ответ не получен в течение 60 секунд (60-секундный интервал зависит от реализации и может быть изменен). В этом случае время ожидания вызова клиента не истекло, пока запущен сервер; Однако если сервер завершается сбоем или теряет СВОЙ IP-адрес, RPC завершает вызов. Указание времени ожидания TCP используется во время установки подключения, а также при обмене запросами и ответами.

Примечание Рекомендуется использовать указание времени ожидания TCP для обнаружения серверов, на которые произошел сбой.

В Windows XP функция поддержания активности для определенного подключения отключается, когда сервер отвечает.

Для удобства для определенных значений в диапазоне времени ожидания предоставляются константы. Список значений, определенных RPC, которые приложение может использовать для аргумента времени ожидания, см. в разделе Привязка констант времени ожидания.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	rpcdce.h (включая Rpc.h)
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также раздел

RpcMgmtInqComTimeout

Поделиться через