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