Поделиться через


Метод IWebSocketContext::ReadFragment

Считывает фрагмент данных из асинхронного соединения.

Синтаксис

virtual HRESULT ReadFragment(  
   _Out_ VOID* pData,  
   _Inout_ DWORD* pcbData,  
   _In_ BOOL fAsync,  
   _Out_ BOOL* pfUTF8Encoded,  
   _Out_ BOOL* pfFinalFragment,  
   _Out_ BOOL* pfConnectionClose,  
   _In_ PFN_WEBSOCKET_COMPLETION pfnCompletion = NULL,   _In_ VOID* pvCompletionContext = NULL,  
   _Out_ BOOL* pfCompletionExpected = NULL  
) = 0;  

Параметры

pData
[OUT] Фрагмент данных, который был прочитан.

pcbData
[IN] [OUT] Число байтов в фрагменте данных.

fAsync
[IN] true Значение , если метод должен выполняться асинхронно; в противном случае — false.

pfUTF8Encoded
[OUT] true значение , если данные кодируются в Юникоде (UTF-8); в противном случае — false.

pfFinalFragment
[OUT] true Значение , если это окончательный фрагмент данных; в противном случае false.

pfConnectionClose
[OUT] true значение , если подключение будет закрыто; в противном случае false.

pfnCompletion
[IN] Указывает на функцию, которая завершит операцию.

pvCompletionContext
[IN] Указывает на сведения о контексте завершения для операции.

pfCompletionExpected
[OUT] true значение , если для этого вызова ожидается асинхронное завершение; в противном случае — false.

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

Объект HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Значение Описание:
S_OK Указывает, что операция выполнена успешно.

Требования

Тип Описание
клиент — IIS 7.0 в Windows Vista
— IIS 7.5 в Windows 7
— IIS 8.0 в Windows 8
— IIS 10.0 в Windows 10
Сервер — IIS 7.0 в Windows Server 2008
— IIS 7.5 в Windows Server 2008 R2
— IIS 8.0 в Windows Server 2012
— IIS 8.5 в Windows Server 2012 R2
— IIS 10.0 в Windows Server 2016
Продукт — IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
— IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Заголовок Iiswebsocket.h

См. также:

Интерфейс IWebSocketContext