WEB_SOCKET_BUFFER_TYPE Enumeration (websocket.h)

Artikel
08/27/2023

Die WEB_SOCKET_BUFFER_TYPE-Enumeration gibt die Bitwerte an, die zum Erstellen des WebSocket-Frameheaders verwendet werden.

Syntax

typedef enum _WEB_SOCKET_BUFFER_TYPE {
  WEB_SOCKET_UTF8_MESSAGE_BUFFER_TYPE = 0x80000000,
  WEB_SOCKET_UTF8_FRAGMENT_BUFFER_TYPE = 0x80000001,
  WEB_SOCKET_BINARY_MESSAGE_BUFFER_TYPE = 0x80000002,
  WEB_SOCKET_BINARY_FRAGMENT_BUFFER_TYPE = 0x80000003,
  WEB_SOCKET_CLOSE_BUFFER_TYPE = 0x80000004,
  WEB_SOCKET_PING_PONG_BUFFER_TYPE = 0x80000005,
  WEB_SOCKET_UNSOLICITED_PONG_BUFFER_TYPE = 0x80000006
} WEB_SOCKET_BUFFER_TYPE;

Konstanten


`WEB_SOCKET_UTF8_MESSAGE_BUFFER_TYPE` Wert: 0x80000000 Gibt an, dass der Puffer den letzten und möglicherweise nur einen Teil einer UTF8-Nachricht enthält.
`WEB_SOCKET_UTF8_FRAGMENT_BUFFER_TYPE` Wert: 0x80000001 Gibt an, dass der Puffer einen Teil einer UTF8-Nachricht enthält.
`WEB_SOCKET_BINARY_MESSAGE_BUFFER_TYPE` Wert: 0x80000002 Gibt an, dass der Puffer den letzten und möglicherweise nur einen Teil einer binären Nachricht enthält.
`WEB_SOCKET_BINARY_FRAGMENT_BUFFER_TYPE` Wert: 0x80000003 Gibt an, dass der Puffer einen Teil einer binären Nachricht enthält.
`WEB_SOCKET_CLOSE_BUFFER_TYPE` Wert: 0x80000004 Gibt an, dass der Puffer eine Close-Meldung enthält.
`WEB_SOCKET_PING_PONG_BUFFER_TYPE` Wert: 0x80000005 Gibt an, dass der Puffer eine Ping- oder Pong-Nachricht enthält. Beim Senden bedeutet dieser Wert "ping". Bei der Verarbeitung empfangener Daten bedeutet dieser Wert "Pong".
`WEB_SOCKET_UNSOLICITED_PONG_BUFFER_TYPE` Wert: 0x80000006 Gibt an, dass der Puffer eine unerwünschte Pongmeldung enthält.

Hinweise

Beachten Sie, dass die Puffertypen FRAGMENT und MESSAGE möglicherweise nicht der Art entsprechen, wie die Nachricht auf der Leitung angezeigt (oder umrahmt wird). Wenn beispielsweise eine einzelne unfragmentierte 1000-Byte-Nachricht empfangen wird, können WebSocket.dll mehrere FRAGMENT-Puffertypen zurückgeben, gefolgt von einem einzelnen MESSAGE-Puffertyp (mit einer Größe von bis zu 1000).

WebSocket-Frameheader der Erweiterung (damit reservierte Bits von Erweiterungen festgelegt werden können) können erstellt werden, indem das hohe Bit (MSB) und das niedrige Bit (LSB) auf 0 festgelegt werden. Die verbleibenden 9 untersten Bits können dann verwendet werden, um den benutzerdefinierten Frameheader anstelle der WEB_SOCKET_BUFFER_TYPE Enumerationswerte zu bilden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	websocket.h

Weitere Informationen

WebSocketGetAction

WebSocketReceive

WebSocketSend

Freigeben über