Writes a PV-WAVE STRING to an established SSL connection.

connection—An SSL_BIO_CTX structure containing the connection information returned by SSL_CLIENT_CONNECT Function.

data—A PV-WAVE STRING containing the instructions for the server.

nbytes—The number of bytes written to the connection stream.

None.

The command string used in the example ssl_demo.pro (which can be found in the SSL_connect lib directory) sends three HTTP commands to the server:

These commands are placed in a single PV-WAVE STRING with carriage return and new-line characters between each command to separate them for the server. The '\r' and '\n' characters in the string are replaced by their hexadecimal ASCII equivalents so they pass through without interpretation on the PV-WAVE side. The STRING ends with another set of the carriage return and new-line characters to signal the end of the commands.

For example, the three commands from the ssl_demo.pro file:

"GET /cgi-bin/randbyte?nbytes=32&format=h HTTP/1.1\r\n"

"Host: www.random.org \r\n"

"Connection: close \r\n\r\n"

Become a single PV-WAVE STRING with the hexadecimal substitutions:

"GET  /cgi-bin/randbyte?nbytes=32&format=h HTTP/1.1\x0D\x0AHost: www.random.org \x0D\x0AConnection: close\x0D\x0A\x0D\x0A"

Note that there should be no spaces between the sets of carriage return and new-line characters and the next command.

For more information and to see this process in use, see the file ssl_demo.pro in the SSL_connect lib directory.

SSL_CLIENT_CLOSE, SSL_CLIENT_CONNECT, SSL_CLIENT_READ, SSL_CONNECT_LOAD