Метод IBackgroundCopyJobHttpOptions::GetSecurityFlags (bits2_5.h)

Извлекает флаги для HTTP, которые определяют, проверяется ли список отзыва сертификатов и игнорируются ли определенные ошибки сертификата, а также политика, используемая при перенаправлении HTTP-запроса сервером.

Синтаксис

HRESULT GetSecurityFlags(
  [out] ULONG *pFlags
);

Параметры

[out] pFlags

Флаги безопасности HTTP, указывающие, какие ошибки следует игнорировать при подключении к серверу. Можно задать один или несколько из следующих флагов:

Значение Значение
BG_SSL_ENABLE_CRL_CHECK
0x0001
Проверьте список отзыва сертификатов (CRL), чтобы убедиться, что сертификат сервера не был отозван.
BG_SSL_IGNORE_CERT_CN_INVALID
0x0002
Игнорирует ошибки, вызванные тем, что имя узла сертификата сервера не соответствует имени узла в запросе.
BG_SSL_IGNORE_CERT_DATE_INVALID
0x0004
Игнорирует ошибки, вызванные сертификатом с истекшим сроком действия.
BG_SSL_IGNORE_UNKNOWN_CA
0x0008
Игнорируйте ошибки, связанные с неизвестным центром сертификации (ЦС).
BG_SSL_IGNORE_CERT_WRONG_USAGE
0x0010
Игнорировать ошибки, связанные с использованием сертификата.
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
0x0000
Позволяет серверу перенаправлять запрос на другой сервер. Это значение по умолчанию.
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
0x0100
Позволяет серверу перенаправлять запрос на другой сервер. BITS обновляет удаленное имя окончательным URL-адресом.
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
Places задание в состоянии неустранимой ошибки, когда сервер перенаправляет запрос на другой сервер. BITS обновляет удаленное имя перенаправленным URL-адресом.
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
Битовая маска, которую можно использовать со значением флага безопасности, чтобы определить, какая политика перенаправления действует. Он не включает ALLOW_HTTPS_TO_HTTP флага.

В следующем примере показано, как использовать эту маску для проверки политики перенаправления BG_HTTP_REDIRECT_POLICY_DISALLOW.

if (BG_HTTP_REDIRECT_POLICY_DISALLOW == (flags & BG_HTTP_REDIRECT_POLICY_MASK))

BG_HTTP_REDIRECT_POLICY_ALLOW_HTTPS_TO_HTTP
0x0800
Позволяет серверу перенаправлять HTTPS-запрос на URL-адрес HTTP.

Этот флаг можно объединить с BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT и BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT.

Возвращаемое значение

Возвращает S_OK при успешном выполнении.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header bits2_5.h (включая Bits.h)
Библиотека Bits.lib

См. также раздел

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetSecurityFlags