структура SCHANNEL_CRED (schannel.h)

Структура SCHANNEL_CRED содержит данные для учетных данных Schannel.

Синтаксис

typedef struct _SCHANNEL_CRED {
  DWORD          dwVersion;
  DWORD          cCreds;
  PCCERT_CONTEXT *paCred;
  HCERTSTORE     hRootStore;
  DWORD          cMappers;
  _HMAPPER       **aphMappers;
  struct         _HMAPPER;
  DWORD          cSupportedAlgs;
  ALG_ID         *palgSupportedAlgs;
  DWORD          grbitEnabledProtocols;
  DWORD          dwMinimumCipherStrength;
  DWORD          dwMaximumCipherStrength;
  DWORD          dwSessionLifespan;
  DWORD          dwFlags;
  DWORD          dwCredFormat;
} SCHANNEL_CRED, *PSCHANNEL_CRED;

Члены

dwVersion

Установите значение SCHANNEL_CRED_VERSION.

cCreds

Количество структур в массиве paCred.

paCred

Массив указателей на CERT_CONTEXT структуры. Каждый указатель указывает сертификат, содержащий закрытый ключ для проверки подлинности приложения. Как правило, этот массив содержит одну структуру для каждого метода обмена ключами, поддерживаемого приложением.

Клиентские приложения часто передают пустой список и зависят от Schannel, чтобы найти соответствующий сертификат или создать сертификат позже при необходимости.

hRootStore

Необязательный. Допустимо только для серверных приложений. Обработка хранилища сертификатов, содержащего самозаверяющие корневых сертификатов для центров сертификации (ЦС), доверенных приложением. Этот элемент используется только серверными приложениями, для которых требуется проверка подлинности клиента.

cMappers

Скрытный.

aphMappers

Скрытный.

_HMAPPER

cSupportedAlgs

Количество алгоритмов в массиве palgSupportedAlgs.

palgSupportedAlgs

Необязательный. Указатель на массив идентификаторов алгоритмов ALG_ID, представляющих алгоритмы, поддерживаемые соединениями, полученными с учетными данными, приобретенными с помощью этой структуры. Если cSupportedAlgs равно нулю или palgSupportedAlgsNULL, Schannel использует системные значения по умолчанию.

В настоящее время идентификаторы алгоритма CALG_AES, CALG_AES_128и CALG_AES_256 не поддерживаются.

grbitEnabledProtocols

Необязательный. DWORD, содержащий битовую строку, представляющую протоколы, поддерживаемые подключениями, полученными с помощью этой структуры. Если этот элемент равен нулю, Schannel выбирает протокол. Для новой разработки приложения должны задать grbitEnabledProtocols равным нулю и использовать версии протокола, включенные в системе по умолчанию.

Этот член используется только поставщиком протокола безопасности Майкрософт пакетом безопасности.

Параметры глобального реестра систем имеют приоритет над этим значением. Например, если ПРОТОКОЛ SSL3 отключен в реестре, его нельзя включить с помощью этого элемента.

Этот элемент может содержать любой из следующих флагов.

dwMinimumCipherStrength

Минимальная сила шифра массового шифрования в битах, разрешенная для подключений.

Если этот элемент равен нулю, Schannel использует системное значение по умолчанию. Если этот член равен –1, включены только наборы шифров SSL3/TLS (также известные как шифр NULL).

dwMaximumCipherStrength

Максимальная сила шифра массового шифрования в битах, разрешенная для подключений.

Если этот элемент равен нулю, Schannel использует системное значение по умолчанию.

Если этот член равен –1, включены только наборы шифров SSL3/TLS (также известные как шифр NULL). В этом случае dwMinimumCipherStrength должно иметь значение –1.

dwSessionLifespan

Количество миллисекунда, которое Schannel сохраняет сеанс в кэше сеансов. После этого все новые подключения между клиентом и сервером требуют нового сеанса Schannel. Задайте для этого элемента значение нулю, чтобы использовать значение по умолчанию 36000000 миллисекунда (десять часов).

dwFlags

Содержит битовые флаги, управляющие поведением Schannel. Этот элемент может быть нулевым или сочетанием следующих значений.

dwCredFormat

Schannel в режиме ядра поддерживает следующие значения.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP и Windows XP/2000: Этот флаг не поддерживается и должен быть нулевым.

Замечания

Следующие флаги отзыва сертификатов являются взаимоисключающими.

• SCH_CRED_REVOCATION_CHECK_CHAIN
• SCH_CRED_REVOCATION_CHECK_END_CERT
• SCH_CRED_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT

Чтобы настроить отчеты об ошибках отзыва сертификатов для Schannel, используйте следующие флаги:

• SCH_CRED_IGNORE_NO_REVOCATION_CHECK
• SCH_CRED_IGNORE_REVOCATION_OFFLINE

Когда Schannel проверяет состояние отзыва цепочки сертификатов, эти флаги указывают ему игнорировать любые CRYPT_E_NO_REVOCATION_CHECK и CRYPT_E_REVOCATION_OFFLINE ошибки соответственно. Эти флаги игнорируются, если флаг отзыва сертификата не задан.

Требования

См. также

QuerySecurityContextToken