TCPStartSSLClientEx Function

Microchip TCP/IP Stack

Microchip TCP/IP Stack Help
TCPStartSSLClientEx Function
C
BOOL TCPStartSSLClientEx(
    TCP_SOCKET hTCP, 
    BYTE* host, 
    void * buffer, 
    BYTE suppDataType
);
Description

This function escalates the current connection to an SSL secured connection by initiating an SSL client handshake.

Preconditions

TCP is initialized and hTCP is already connected.

Parameters
Parameters 
Description 
hTCP 
TCP connection to secure 
host 
Expected host name on certificate (currently ignored) 
buffer 
Buffer for supplementary data return 
suppDataType 
Type of supplementary data to copy 
Return Values
Return Values 
Description 
TRUE 
an SSL connection was initiated 
FALSE 
Insufficient SSL resources (stubs) were available 
Remarks

The host parameter is currently ignored and is not validated.

Microchip TCP/IP Stack 5.42.08 - June 15, 2013
Copyright © 2012 Microchip Technology, Inc.  All rights reserved.