CmpTlsWrite (FUN)

FUNCTION CmpTlsWrite : __XINT

Send data over the encrypted channel. If the connection is not established yet, this will be done transparent in the background. Normally only data is written to the unterlaying IO. In some cases data have to be read (Handshaking has not finished or renegotiation of the session keys). If not data is for reading is available this will be indicated through the corresponding error code.

InOut:

Scope

Name

Type

Comment

Return

CmpTlsWrite

__XINT

Number of bytes sent. 0 if an error occured.

Input

hTlsConn

RTS_IEC_HANDLE

Handle of the TLS connection, created with one of the TLSxxxOpen functions

pbyData

POINTER TO BYTE

Pointer to data, that should be sent over the TLS connection

xiDataSize

__XINT

Size of pbyData. Number of bytes that should be sent over the TLS connection

pResult

POINTER TO RTS_IEC_RESULT
Result OF THIS operation. May be one OF these values:

  • ERR_OK: No error. Everything worked as expected.

  • ERR_NOTINITIALIZED: The TLS component was not initialized proberly.

  • ERR_TLS_CONNECTION_CLOSED: The TLS connection is closed. Use TlsShutdown to shutdown locally.

  • ERR_TLS_WANT_READ: The operation needs TO read data FROM the IO system. There is no data available.

  • ERR_TLS_WANT_WRITE: The operation needs to write data to the IO system. This is not possible.

  • ERR_TLS_RETRY_OPERATION: Something went wrong. Try the same function call again

  • ERR_TLS_IO_SYSTEM: An error in the unterlaying IO system.

  • ERR_TLS_INTERNAL: An internal Error of the TLS Component

  • ERR_FAILED: Unknown error.