Freigeben über


WEB_SOCKET_PROPERTY_TYPE Enumeration (websocket.h)

Die WEB_SOCKET_PROPERTY_TYPE-Enumeration gibt einen WebSocket-Eigenschaftstyp an.

Syntax

typedef enum _WEB_SOCKET_PROPERTY_TYPE {
  WEB_SOCKET_RECEIVE_BUFFER_SIZE_PROPERTY_TYPE = 0,
  WEB_SOCKET_SEND_BUFFER_SIZE_PROPERTY_TYPE = 1,
  WEB_SOCKET_DISABLE_MASKING_PROPERTY_TYPE = 2,
  WEB_SOCKET_ALLOCATED_BUFFER_PROPERTY_TYPE = 3,
  WEB_SOCKET_DISABLE_UTF8_VERIFICATION_PROPERTY_TYPE = 4,
  WEB_SOCKET_KEEPALIVE_INTERVAL_PROPERTY_TYPE = 5,
  WEB_SOCKET_SUPPORTED_VERSIONS_PROPERTY_TYPE = 6
} WEB_SOCKET_PROPERTY_TYPE;

Konstanten

 
WEB_SOCKET_RECEIVE_BUFFER_SIZE_PROPERTY_TYPE
Wert: 0
Eigenschaftstyp: ULONG

Die WebSocket-Eigenschaft ist die interne Empfangspuffergröße. Der Puffer darf nicht kleiner als 256 Bytes sein.

Der Standardwert lautet 4096.

Wird mit WebSocketCreateClientHandle und WebSocketCreateServerHandle verwendet.
WEB_SOCKET_SEND_BUFFER_SIZE_PROPERTY_TYPE
Wert: 1
Eigenschaftstyp: ULONG

Die WebSocket-Eigenschaft ist die interne Sendepuffergröße. Der Puffer darf nicht kleiner als 256 Bytes sein.

Der Standardwert ist 4096 für ein Handle, das mit WebSocketCreateClientHandle erstellt wurde, und 16 für ein mit WebSocketCreateServerHandle erstelltes Handle.

Wird mit WebSocketCreateClientHandle und WebSocketCreateServerHandle verwendet.
WEB_SOCKET_DISABLE_MASKING_PROPERTY_TYPE
Wert: 2
Eigenschaftstyp: BOOL

Die WebSocket-Eigenschaft ist das Deaktivieren des Maskenbits in Clientframes. Auf dem Client legt diese Eigenschaft den Maskenschlüssel auf 0 fest. Auf dem Server ermöglicht diese Eigenschaft dem Server, Clientframes zu akzeptieren, bei denen das Maskenbit auf 0 festgelegt ist. Diese Eigenschaft kann schwerwiegende Auswirkungen auf die Sicherheit haben.
Standardmäßig wird diese Eigenschaft nicht verwendet, und die Maskierung ist aktiviert.

Wird mit WebSocketCreateClientHandle und WebSocketCreateServerHandle verwendet.
WEB_SOCKET_ALLOCATED_BUFFER_PROPERTY_TYPE
Wert: 3
Eigenschaftstyp: PVOID

Die WebSocket-Eigenschaft ist der Puffer, der als interner Puffer verwendet wird. Wenn der übergebene Puffer nicht verwendet wird, übernimmt die WebSocket-Bibliothek die Pufferverwaltung.
Der übergebene Puffer muss an einer 8-Byte-Grenze ausgerichtet sein und größer als die Empfangspuffergröße + Sendepuffergröße + 256 Bytes sein.

Wird mit WebSocketCreateClientHandle und WebSocketCreateServerHandle verwendet.
WEB_SOCKET_DISABLE_UTF8_VERIFICATION_PROPERTY_TYPE
Wert: 4
Eigenschaftstyp: BOOL

Die WebSocket-Eigenschaft deaktiviert die UTF-8-Überprüfung.

Wird mit WebSocketCreateClientHandle und WebSocketCreateServerHandle verwendet.
WEB_SOCKET_KEEPALIVE_INTERVAL_PROPERTY_TYPE
Wert: 5
Eigenschaftstyp: ULONG

Die WebSocket-Eigenschaft ist das Intervall in Millisekunden, um ein Keep-Alive-Paket über die Verbindung zu senden. Das Standardintervall ist 30000 (30 Sekunden). Das Mindestintervall ist 15.000 (15 Sekunden).
Hinweis Der Standardwert für das Keep-Alive-Intervall ist aus HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval gelesen. Wenn kein Wert festgelegt ist, wird der Standardwert 30000 verwendet. Es ist nicht möglich, ein niedrigeres Halteintervall als 15.000 Millisekunden zu haben. Wenn ein niedrigerer Wert festgelegt wird, werden 15000 Millisekunden verwendet.

 



Wird mit WebSocketGetGlobalProperty verwendet.
WEB_SOCKET_SUPPORTED_VERSIONS_PROPERTY_TYPE
Wert: 6
Eigenschaftstyp: ULONG-Array

Die WebSocket-Eigenschaft ist die unterstützten Versionen des WebSocket-Protokolls.


Wird mit WebSocketGetGlobalProperty verwendet.

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

WEB_SOCKET_PROPERTY

WebSocketReceive

WebSocketSend