Module: Secure Communication Module Package: HTTPS
RWHttpsSecureSocketClientRWHttpClient
make() operator=() |
RWHttpsConnectionStart RWHttpsSecureSocketClient() |
secureUpgrade() ~RWHttpsSecureSocketClient() |
#include <rw/https/RWHttpsSecureSocketClient.h>
RWHttpsSecureSocketClient is a derived handle class for RWHttpClient. It provides implementation specific details for HTTPS clients over SSL/TLS enabled sockets.
enum RWHttpsConnectionStart { RW_HTTPS_START_SECURE, // Starts a secure connection RW_HTTPS_START_INSECURE // Starts an insecure connection };
Determines the initial security setting of a secure socket client.
RWHttpsSecureSocketClient();
Default constructor. Constructs an invalid handle.
RWHttpsSecureSocketClient(const RWHttpsSecureSocketClient&);
Copy constructor.
virtual ~RWHttpsSecureSocketClient();
Virtual destructor.
RWHttpsSecureSocketClient& operator=(const RWHttpsSecureSocketClient& other);
Assignment operator.
static RWHttpsSecureSocketClient make(const RWSecureSocketContext& context, RWHttpsConnectionStart s = RW_HTTPS_START_SECURE);
Creates a new initialized RWHttpsSecureSocketClient. You must provide an initialized RWSecureSocketContext object. The RWHttpsConnectionStart parameter determines whether the connection starts in secure mode (the default) or in insecure mode. If the RWHttpsConnectionStart parameter is RW_HTTPS_START_SECURE, the connection starts in secure mode. If the RWHttpsConnectionStart parameter is RW_HTTPS_START_INSECURE, the connection starts in insecure mode and waits until the secureUpgrade() member function is called before switching to secure mode.
You can use this function with the HTTP CONNECT method to connect insecurely to a proxy machine and establish a tunnel to a secure machine. After the tunnel is established, use secureUpgrade() to start communicating securely. For more information, see Section 8.2, "Using the HTTP CONNECT Method with the HTTPS Package," in the Secure Communication Module User's Guide.
bool secureUpgrade();
Begins secure communication on this connection. Returns true on success. If the connection is already secure, simply returns true. Returns false on error.
Call this function only when the RWHttpsSecureSocketClient object starts with an insecure connection by passing RW_HTTPS_START_INSECURE as the second parameter to the static make() function.
© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.