Fungsi WebSocketSend (websocket.h)

Fungsi WebSocketSend menambahkan operasi kirim ke antrean operasi komponen protokol.

Sintaks

HRESULT WebSocketSend(
  [in]           WEB_SOCKET_HANDLE      hWebSocket,
  [in]           WEB_SOCKET_BUFFER_TYPE BufferType,
  [in, optional] WEB_SOCKET_BUFFER      *pBuffer,
  [in, optional] PVOID                  Context
);

Parameter

[in] hWebSocket

Jenis: WEB_SOCKET_HANDLE

Handel sesi WebSocket yang dikembalikan oleh panggilan sebelumnya ke WebSocketCreateClientHandle atau WebSocketCreateServerHandle.

[in] BufferType

Jenis: WEB_SOCKET_BUFFER_TYPE

Jenis data buffer WebSocket untuk dikirim dalam pBuffer.

[in, optional] pBuffer

Jenis: WEB_SOCKET_BUFFER*

Penunjuk ke array struktur WEB_SOCKET_BUFFER yang berisi data buffer WebSocket untuk dikirim. Jika BufferTypeWEB_SOCKET_PING_PONG_BUFFER_TYPE atau WEB_SOCKET_UNSOLICITED_PONG_BUFFER_TYPE, pBuffer harus NULL.

Catatan Setelah WEB_SOCKET_INDICATE_SEND_COMPLETE dikembalikan oleh WebSocketGetAction untuk tindakan ini, penunjuk memori ke oleh pBuffer dapat diklaim kembali.

 

[in, optional] Context

Jenis: PVOID

Penunjuk ke handel konteks aplikasi yang akan dikembalikan oleh panggilan berikutnya ke WebSocketGetAction.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan salah satu dari kode kesalahan berikut atau sistem yang ditentukan dalam WinError.h.

Menampilkan kode	Deskripsi
E_INVALID_PROTOCOL_OPERATION	Protokol melakukan operasi yang tidak valid.

Keterangan

Setelah aplikasi berhasil mengirim buffer WebSocket WEB_SOCKET_CLOSE_BUFFER_TYPE , aplikasi hanya dapat mengirim bingkai kontrol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	websocket.h
Pustaka	Websocket.lib
DLL	Websocket.dll

Lihat juga

WEB_SOCKET_ACTION

WebSocketAbortHandle

WebSocketCompleteAction

WebSocketGetAction

WebSocketReceive