IInternetConnectionEndPoint::CancelOperations: различия между версиями
Строка 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 - при условии что операции ввода вывода с созданными потоками не выполняются до завершения ожидания.