Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
IBackgroundCopyJobHttpOptions::GetSecurityFlags method (bits2_5.h)
Retrieves the flags for HTTP that determine whether the certificate revocation list is checked and certain certificate errors are ignored, and the policy to use when a server redirects the HTTP request.
Syntax
HRESULT GetSecurityFlags(
[out] ULONG *pFlags
);
Parameters
[out] pFlags
HTTP security flags that indicate which errors to ignore when connecting to the server. One or more of the following flags can be set:
| Value | Meaning |
|---|---|
|
Check the certificate revocation list (CRL) to verify that the server certificate has not been revoked. |
|
Ignores errors caused when the certificate host name of the server does not match the host name in the request. |
|
Ignores errors caused by an expired certificate. |
|
Ignore errors associated with an unknown certification authority (CA). |
|
Ignore errors associated with the use of a certificate. |
|
Allows the server to redirect your request to another server. This is the default. |
|
Allows the server to redirect your request to another server. BITS updates the remote name with the final URL. |
|
Places the job in the fatal error state when the server redirects your request to another server. BITS updates the remote name with the redirected URL. |
|
Bitmask that you can use with the security flag value to determine which redirect policy is in effect. It does not include the flag ALLOW_HTTPS_TO_HTTP.
The following example shows how to use this mask to test for the BG_HTTP_REDIRECT_POLICY_DISALLOW redirection policy.
|
|
Allows the server to redirect an HTTPS request to an HTTP URL.
You can combine this flag with BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT and BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT. |
Return value
Returns S_OK when successful.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | bits2_5.h (include Bits.h) |
| Library | Bits.lib |
See also
Feedback
Was this page helpful?