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

Статья
03/01/2024

Сервер вызывает RpcServerTestCancel для тестирования запросов на отмену клиента.

Синтаксис

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Параметры

BindingHandle

Вызовите для проверки команд отмены. Если указано нулевое значение, сервер олицетворяет клиент, обслуживаемый этим потоком сервера.

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

Значение	Значение
RPC_S_OK	Вызов был отменен клиентом. Сервер по-прежнему должен завершить или прервать вызов.
RPC_S_NO_CALL_ACTIVE	В текущем потоке нет активного вызова.
RPC_S_CALL_IN_PROGRESS	Звонок не был отменен.
RPC_S_INVALID_BINDING	Недопустимый дескриптор.

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

Сервер вызывает RpcServerTestCancel , чтобы узнать, запросил ли клиент отмену невыполненных вызовов. Функция RpcServerTestCancel только указывает, отменил ли клиент вызов; состояние не изменяется на сервере или клиенте. Отмененный вызов по-прежнему должен быть завершен или прерван сервером RPC с помощью вызовов функций RpcAsyncCompleteCall или RpcAsyncAbortCall соответственно.

Параметр BindingHandle указывает вызов, на котором выполняется тестирование. Если параметр имеет нулевое значение, вызов в текущем потоке проверяется. Сервер может вызвать функцию RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) для проверки сообщения об отмене с помощью асинхронного дескриптора для получения дескриптора привязки.

Требования

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