TLS_PARAMETERS-Struktur (schannel.h)

  • Artikel

Gibt TLS-Parametereinschränkungen an.

Syntax

typedef struct _TLS_PARAMETERS {
  DWORD            cAlpnIds;
  PUNICODE_STRING  rgstrAlpnIds;
  DWORD            grbitDisabledProtocols;
  DWORD            cDisabledCrypto;
  PCRYPTO_SETTINGS pDisabledCrypto;
  DWORD            dwFlags;
} TLS_PARAMETERS, *PTLS_PARAMETERS;

Member

cAlpnIds

Die Anzahl der ALPN-Ids in rgstrAlpnIds.

Legen Sie auf 0 fest, wenn die folgenden Parametereinschränkungen unabhängig vom ausgehandelten Anwendungsprotokoll gelten. Es ist ein Fehler, mehr als SCH_CRED_MAX_SUPPORTED_ALPN_IDS anzugeben.

rgstrAlpnIds

Ein Array von ALPN-IDs, für die die folgenden Parameter gelten.

Legen Sie auf NULL fest, wenn Parametereinschränkungen unabhängig vom ausgehandelten Anwendungsprotokoll gelten.

grbitDisabledProtocols

Die Bitzeichenfolge, die die deaktivierten Protokolle darstellt.

Legen Sie auf 0 fest, um die Systemstandardeinstellungen zu verwenden. Schannel-Protokollflags sind hier dokumentiert.

cDisabledCrypto

Die Anzahl der Einträge im pDisabledCrypto-Array. Es ist ein Fehler, mehr als SCH_CRED_MAX_SUPPORTED_CRYPTO_SETTINGS anzugeben.

pDisabledCrypto

Ein Array von Zeigern auf die CRYPTO_SETTINGS Strukturen, die deaktivierte kryptografische Einstellungen ausdrücken.

dwFlags

(optional) Die zu übergebenden Flags.

Wenn TLS_PARAMS_OPTIONAL festgelegt ist, werden TLS_PARAMETERS nur berücksichtigt, wenn sie nicht dazu führen, dass der Server den Handshake beendet.

Andernfalls schlägt schannel möglicherweise TLS-Handshakes fehl, um die TLS_PARAMETERS Einschränkungen zu beachten.

Hinweis

TLS_PARAMS_OPTIONAL ist nur für Serveranwendungen gültig. Andernfalls muss null sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 1809 [nur Desktop-Apps]
Kopfzeile schannel.h

Weitere Informationen

SCH_CREDENTIALS

CRYPTO_SETTINGS