Symbol

Meaning

%ServerXMLHTTP_UNINITIALIZED

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

%ServerXMLHTTP_LOADING

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

%ServerXMLHTTP_LOADED

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

%ServerXMLHTTP_INTERACTIVE

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

%ServerXMLHTTP_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 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 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 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 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")