Symbol

Meaning

%HTTP_UNINITIALIZED

The object has been created but has not been initialized because the open method has not been called.

%HTTP_LOADING

The object has been created but the send method has not been called.

%HTTP_LOADED

The send method has been called and the status and headers are available, but the response is not yet available.

%HTTP_INTERACTIVE

Some data has been received. You can call responseBody and responseText to get the current partial results.

%HTTP_COMPLETED

All the data has been received, and the complete data is available in responseText.

Symbol

Meaning

%SXH_OPTION_URL

This option allows the client to learn the final URL last used.

For example, after a call made using the <cHTTP_Client>.Send method has completed, you can use this option to check the URL and see if any redirection occurred. The URL, however, cannot be read until the <cHTTP_Client>.Open method is next called.

%SXH_OPTION_URL_CODEPAGE

%SXH_OPTION_ESCAPE_PERCENT_IN_URL

By default, escaping unsafe ANSI characters in the URL (for example, " " -> "%20") does not escape the % character itself.

This option allows the client to change this behavior. The client should specify a Boolean True/False value for this option.

%SXH_OPTION_IGNORE_SERVER_SSL_CERT_ERROR_FLAGS

This option is a DWORD mask of various flags that can be set to change this default behavior.

The default value is to ignore all problems.

You must set this option before calling the <cHTTP_Client>.Send method.

The flags are as follows:

%SXH_SERVER_CERT_IGNORE_UNKNOWN_CA: Unknown certificate authority

%SXH_SERVER_CERT_IGNORE_WRONG_USAGE: Malformed certificate such as a certificate with no subject name.

%SXH_SERVER_CERT_IGNORE_CERT_CN_INVALID: Mismatch between the visited hostname and the certificate name being used on the server.

%SXH_SERVER_CERT_IGNORE_CERT_DATE_INVALID: The date in the certificate is invalid or has expired.

%SXH_SERVER_CERT_IGNORE_ALL_SERVER_ERRORS: All certificate errors.

To turn off a flag, you subtract it from the default value, which is the sum of all flags.

For example, to catch an invalid date in a certificate, you turn off the %SXH_SERVER_CERT_IGNORE_CERT_DATE_INVALID flag as follows:

shx.setOption(%SXH_OPTION_IGNORE_SERVER_SSL_CERT_ERROR_FLAGS, 

(shx.getOption(%SXH_OPTION_IGNORE_SERVER_SSL_CERT_ERROR_FLAGS) - 

%SXH_SERVER_CERT_IGNORE_CERT_DATE_INVALID)

%SXH_OPTION_SELECT_CLIENT_SSL_CERT

By default, the value of this option is an empty string (""), which means pick the first certificate in the local store to send if the server requests a client certificate.

This option is a string that lets you select which client certificate from the local store should be sent.

You must set this option before calling the <cHTTP_Client>.Send method.

The following example sets the client certificate option to request the client certificate named "MSXML":

shx.SetOption(%SXH_OPTION_SELECT_CLIENT_SSL_CERT, "MSXML")