IInternetConnectionEndPoint::CancelOperations: различия между версиями

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
Строка 4: Строка 4:
В результате вызова метода любые текущие и будущие операции ввода-вывода над потоками данных, порожденными данной реализацией точки доступа '''до вызова''' метода [[IInternetConnectionEndPoint::CancelOperations|CancelOperations]], будут прерваны и вернут код завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f).
В результате вызова метода любые текущие и будущие операции ввода-вывода над потоками данных, порожденными данной реализацией точки доступа '''до вызова''' метода [[IInternetConnectionEndPoint::CancelOperations|CancelOperations]], будут прерваны и вернут код завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f).


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

Версия 17:10, 12 августа 2017

 return_code_t CancelOperations() noexcept;

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

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

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

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