WEB_SOCKET_PROPERTY_TYPE列舉會指定 WebSocket 屬性類型。
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;
常數
WEB_SOCKET_RECEIVE_BUFFER_SIZE_PROPERTY_TYPE值: 0 屬性類型: ULONG WebSocket 屬性是內部接收緩衝區大小。 緩衝區不能小於 256 個位元組。 預設值是 4096。 與 WebSocketCreateClientHandle 和 WebSocketCreateServerHandle 搭配使用。 |
WEB_SOCKET_SEND_BUFFER_SIZE_PROPERTY_TYPE值: 1 屬性類型: ULONG WebSocket 屬性是內部傳送緩衝區大小。 緩衝區不能小於 256 個位元組。 預設值為 使用 WebSocketCreateClientHandle建立的控制碼上為 4096,而使用 WebSocketCreateServerHandle建立的控制碼則為 16。 與 WebSocketCreateClientHandle 和 WebSocketCreateServerHandle 搭配使用。 |
WEB_SOCKET_DISABLE_MASKING_PROPERTY_TYPE值: 2 屬性類型: BOOL WebSocket 屬性是停用用戶端畫面格中的遮罩位。 在用戶端上,這個屬性會將遮罩鍵設定為 0。 在伺服器上,這個屬性可讓伺服器接受用戶端畫面,並將遮罩位設定為 0。 這個屬性可能會有嚴重的安全性影響。 根據預設,不會使用這個屬性,而且會啟用遮罩。 與 WebSocketCreateClientHandle 和 WebSocketCreateServerHandle 搭配使用。 |
WEB_SOCKET_ALLOCATED_BUFFER_PROPERTY_TYPE值: 3 屬性類型: PVOID WebSocket 屬性是做為內部緩衝區的緩衝區。 如果未使用傳遞的緩衝區,WebSocket 程式庫會負責處理緩衝區管理。 傳遞的緩衝區必須對齊 8 位元組界限,且大小大於接收緩衝區大小 + 傳送緩衝區大小 + 256 個位元組。 與 WebSocketCreateClientHandle 和 WebSocketCreateServerHandle 搭配使用。 |
WEB_SOCKET_DISABLE_UTF8_VERIFICATION_PROPERTY_TYPE值: 4 屬性類型: BOOL WebSocket 屬性會停用 UTF-8 驗證。 與 WebSocketCreateClientHandle 和 WebSocketCreateServerHandle 搭配使用。 |
WEB_SOCKET_KEEPALIVE_INTERVAL_PROPERTY_TYPE值: 5 屬性類型: ULONG WebSocket 屬性是間隔,以毫秒為單位,透過連線傳送 Keep-alive 封包。 預設間隔為 30000 (30 秒) 。 最小間隔為 15000 (15 秒) 。
注意 保持運作間隔的預設值是從 HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval讀取。 如果未設定值,則會使用預設值 30000。 無法讓保留間隔低於 15000 毫秒。 如果設定較低的值,則會使用 15000 毫秒。 與 WebSocketGetGlobalProperty搭配使用。 |
WEB_SOCKET_SUPPORTED_VERSIONS_PROPERTY_TYPE值: 6 屬性類型: ULONG 陣列 WebSocket 屬性是支援的 WebSocket 通訊協定版本。 與 WebSocketGetGlobalProperty搭配使用。 |
規格需求
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 標頭 | websocket.h |