IInternetConnectionEndPoint::CancelOperations: различия между версиями
(Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.) |
|||
| (не показаны 2 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
{{function_begin | return_code_t CancelOperations() noexcept; |{{IInternetConnectionEndPoint::CancelOperations brief}}}} | {{function_begin | return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CancelOperations() noexcept; |{{IInternetConnectionEndPoint::CancelOperations brief}}}} | ||
{{function_return_value|32-битовый целый код ошибки, отрицательный в случае ошибки (старший бит установлен).}} | {{function_return_value|32-битовый целый код ошибки, отрицательный в случае ошибки (старший бит установлен).}} | ||
{{function_end}} | {{function_end}} | ||
В результате вызова метода любые текущие и будущие операции ввода-вывода над потоками данных, порожденными данной реализацией точки доступа '''до вызова''' метода [[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]] - при условии что операции ввода вывода с созданными потоками не выполняются до завершения ожидания. | ||
Текущая версия на 00:59, 18 декабря 2017
return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CancelOperations() noexcept;
Прерывает соединение с использованием протокола разрыва, если это возможно, иначе - жестко, и разблокирует любые потоки выполнения, заблокированные доступом к удаленному узлу через связанные с точкой доступа потоки чтения и записи.
- Возвращаемое значение:
- 32-битовый целый код ошибки, отрицательный в случае ошибки (старший бит установлен).
В результате вызова метода любые текущие и будущие операции ввода-вывода над потоками данных, порожденными данной реализацией точки доступа до вызова метода CancelOperations, будут прерваны и вернут код завершения CHSVERROR_SUCCESS_CANCELLED (0x2417000f).
Реализация TCP протокола, возвращаемая функциями CreateTCPServer или CreateTCPClient, разрешает повторное использование текущей реализации, однако прежде необходимо закрыть любые существующие экземпляры потоков данных, связанных с точкой доступа, затем дождаться статуса InternetIdle, после чего вновь создать потоки данных посредством вызова соответствующих методов интерфейса IConsequentDataStorage. Новые экземпляры потоков данных также можно создать до ожидания статуса InternetIdle - при условии что операции ввода вывода с созданными потоками не выполняются до завершения ожидания.