Método IWebSocketContext::ReadFragment
Lê um fragmento de dados de uma conexão assíncrona.
Sintaxe
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;
Parâmetros
pData
[OUT] Fragmento de dados que foi lido.
pcbData
[IN] [OUT] Número de bytes no fragmento de dados.
fAsync
[IN] true se o método deve ser concluído de forma assíncrona; caso contrário, false.
pfUTF8Encoded
[OUT] true se os dados forem codificados em Unicode (UTF-8) ; caso contrário, false.
pfFinalFragment
[OUT] true se este for o fragmento de dados final; caso contrário false, .
pfConnectionClose
[OUT] true se a conexão for fechada; caso contrário false, .
pfnCompletion
[IN] Aponta para a função que concluirá a operação.
pvCompletionContext
[IN] Aponta para as informações de contexto de conclusão da operação.
pfCompletionExpected
[OUT] true se uma conclusão assíncrona estiver pendente para esta chamada; caso contrário, false.
Valor Retornado
Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Valor | Descrição |
|---|---|
| S_OK | Indica que a operação foi bem-sucedida. |
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | – IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10 |
| Servidor | – IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016 |
| Produto | - 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 |
| parâmetro | Iiswebsocket.h |