setOption Method
Sets one of the following options:
SXH_OPTION_URL_CODEPAGE
SXH_OPTION_ESCAPE_PERCENT_IN_URL
SXH_OPTION_IGNORE_SERVER_SSL_CERT_ERROR_FLAGS
SXH_OPTION_SELECT_CLIENT_SSL_CERT
For more information about these options, see Remarks.
Script Syntax
oServerXMLHTTPRequest.setOption(option, value);
Parameters
- option
- The option whose value is to be set.
- value
- The value to which the specified option is to be set.
Visual Basic Syntax
oServerXMLHTTPRequest.setOption(option, value)
Parameters
- option
- The option whose value is to be set.
- value
- The value to which the specified option is to be set.
C/C++ Syntax
HRESULT setOption(SERVERXMLHTTP_OPTION option, VARIANT value);
Parameters
- option [in]
- The option whose value is to be set.
- value [in]
- The value to which the specified option is to be set.
C/C++ Return Values
- S_OK
- Value returned if successful.
To view reference information for Visual Basic, C/C++, or Script only, click the Language Filter button in the upper-left corner of the page.
Remarks
The following table lists the options available to the setOption
method.
Option | Description |
---|---|
0 |
SXH_OPTION_URL_CODEPAGE
By default, CP_UTF8 is the code page used to convert the Unicode URL string (specified in the The |
1 |
SXH_OPTION_ESCAPE_PERCENT_IN_URL
By default, escaping unsafe ANSI characters in the URL (for example, " " -> "%20") does not escape the % character itself. The SXH_OPTION_ESCAPE_PERCENT_IN_URL option allows the client to change this behavior. The client should specify a Boolean True/False value for this option. |
2 |
SXH_OPTION_IGNORE_SERVER_SSL_CERT_ERROR_FLAGS
Unknown certificate authority
Malformed certificate such as a certificate with no subject name.
Mismatch between the visited hostname and the certificate name being used on the server.
The date in the certificate is invalid or has expired.
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 shx.setOption(2, shx.getOption(2) _ - SXH_SERVER_CERT_IGNORE_CERT_DATE_INVALID) |
3 |
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. The shx.setOption(3, "MSXML") |
Note Option –1,SXH_OPTION_URL
, is a read-only return value, and can therefore not be set by thesetOption
method. For more information about this option, see getOption Method.
See Also
Applies to: IServerXMLHTTPRequest/ServerXMLHTTP