IInternetConnectionEndPoint::CancelOperations

Материал из CAMaaS preliminary wiki
Версия от 00:59, 18 декабря 2017; Андрей Чусов (обсуждение | вклад) (Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску
 return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CancelOperations() noexcept;

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

Возвращаемое значение:
32-битовый целый код ошибки, отрицательный в случае ошибки (старший бит установлен).

В результате вызова метода любые текущие и будущие операции ввода-вывода над потоками данных, порожденными данной реализацией точки доступа до вызова метода CancelOperations, будут прерваны и вернут код завершения CHSVERROR_SUCCESS_CANCELLED (0x2417000f).

Реализация TCP протокола, возвращаемая функциями CreateTCPServer или CreateTCPClient, разрешает повторное использование текущей реализации, однако прежде необходимо закрыть любые существующие экземпляры потоков данных, связанных с точкой доступа, затем дождаться статуса InternetIdle, после чего вновь создать потоки данных посредством вызова соответствующих методов интерфейса IConsequentDataStorage. Новые экземпляры потоков данных также можно создать до ожидания статуса InternetIdle - при условии что операции ввода вывода с созданными потоками не выполняются до завершения ожидания.