Freigeben über


IWebSocketContext::ReadFragment-Methode

Liest ein Datenfragment aus einer asynchronen Verbindung.

Syntax

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;  

Parameter

pData
[OUT] Datenfragment, das gelesen wurde.

pcbData
[IN] [OUT] Anzahl der Bytes im Datenfragment.

fAsync
[IN] true , wenn die Methode asynchron abgeschlossen werden soll; falseandernfalls .

pfUTF8Encoded
[OUT] true , wenn die Daten Unicode(UTF-8) codiert sind; falseandernfalls .

pfFinalFragment
[OUT] true , wenn dies das endgültige Datenfragment ist; andernfalls false.

pfConnectionClose
[OUT] true , wenn die Verbindung geschlossen wird; andernfalls false.

pfnCompletion
[IN] Zeigt auf die Funktion, die den Vorgang abschließt.

pvCompletionContext
[IN] Verweist auf die Vervollständigungskontextinformationen für den Vorgang.

pfCompletionExpected
[OUT] true , wenn für diesen Aufruf eine asynchrone Vervollständigung aussteht; falseandernfalls .

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert BESCHREIBUNG
S_OK Gibt an, dass der Vorgang erfolgreich war.

Anforderungen

type BESCHREIBUNG
Client – IIS 7.0 unter Windows Vista
– IIS 7.5 unter Windows 7
– IIS 8.0 unter Windows 8
– IIS 10.0 auf Windows 10
Server – IIS 7.0 unter Windows Server 2008
– IIS 7.5 unter Windows Server 2008 R2
– IIS 8.0 unter Windows Server 2012
– IIS 8.5 unter Windows Server 2012 R2
– IIS 10.0 auf Windows Server 2016
Produkt – 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
Header Iiswebsocket.h

Weitere Informationen

IWebSocketContext-Schnittstelle