struktur SecPkgContext_ConnectionInfo (schannel.h)

  • Artikel

Struktur SecPkgContext_ConnectionInfo berisi protokol dan informasi sandi. Struktur ini digunakan oleh fungsi InitializeSecurityContext (Schannel).

Atribut ini hanya didukung oleh penyedia dukungan keamanan (SSP) Schannel.

Sintaks

typedef struct _SecPkgContext_ConnectionInfo {
  DWORD  dwProtocol;
  ALG_ID aiCipher;
  DWORD  dwCipherStrength;
  ALG_ID aiHash;
  DWORD  dwHashStrength;
  ALG_ID aiExch;
  DWORD  dwExchStrength;
} SecPkgContext_ConnectionInfo, *PSecPkgContext_ConnectionInfo;

Anggota

dwProtocol

Protokol yang digunakan untuk membuat sambungan ini. Tabel berikut ini menjelaskan konstanta yang valid untuk anggota ini.

Nilai Makna
SP_PROT_SSL2_CLIENT
8 (0x8)
 Secure Sockets Layer 2.0 client-side. Digantikan oleh SP_PROT_TLS1_CLIENT.
SP_PROT_SSL2_SERVER
4 (0x4)
 Secure Sockets Layer 2.0 sisi server. Digantikan oleh SP_PROT_TLS1_SERVER.
SP_PROT_SSL3_CLIENT
32 (0x20)
 Secure Sockets Layer 3.0 client-side.
SP_PROT_SSL3_SERVER
16 (0x10)
 Secure Sockets Layer 3.0 sisi server.
SP_PROT_TLS1_0_CLIENT
128 (0x80)
 Keamanan Lapisan Transportasi 1.0 sisi klien.
SP_PROT_TLS1_0_SERVER
64 (0x40)
 Keamanan Lapisan Transportasi 1.0 sisi server.
SP_PROT_TLS1_1_CLIENT
512 (0x200)
 Keamanan Lapisan Transportasi 1.1 sisi klien.
SP_PROT_TLS1_1_SERVER
256 (0x100)
 Keamanan Lapisan Transportasi 1.1 sisi server.
SP_PROT_TLS1_2_CLIENT
2048 (0x800)
 Keamanan Lapisan Transportasi 1.2 sisi klien.
SP_PROT_TLS1_2_SERVER
1024 (0x400)
 Keamanan Lapisan Transportasi 1.2 sisi server.
SP_PROT_TLS1_3_CLIENT
8192 (0x2000)
 Keamanan Lapisan Transportasi 1.3 sisi klien.
SP_PROT_TLS1_3_SERVER
4096 (0x1000)
 Keamanan Lapisan Transportasi 1.3 sisi server.
SP_PROT_DTLS1_0_CLIENT
131072 (0x00020000)
 Keamanan Lapisan Transportasi Datagram 1.0 sisi klien.
SP_PROT_DTLS1_0_SERVER
65536 (0x00010000)
 Keamanan Lapisan Transportasi Datagram 1.0 sisi server.
SP_PROT_DTLS1_2_CLIENT
524288 (0x00080000)
 Keamanan Lapisan Transportasi Datagram 1.2 sisi klien.
SP_PROT_DTLS1_2_SERVER
262144 (0x00040000)
 Keamanan Lapisan Transportasi Datagram 1.2 sisi server.

aiCipher

Pengidentifikasi algoritma (ALG_ID) untuk cipher enkripsi massal yang digunakan oleh koneksi ini. Tabel berikut ini menjelaskan konstanta yang valid untuk anggota ini.

Nilai Makna
CALG_3DES
 Algoritma enkripsi blok 3DES
CALG_AES_128
 Algoritma enkripsi AES 128-bit
CALG_AES_256
 Algoritma enkripsi AES 256-bit
CALG_DES
 Algoritma enkripsi DES
CALG_RC2
 Algoritma enkripsi blok RC2
CALG_RC4
 Algoritma enkripsi aliran RC4
0 (Nol)
 Tidak ada enkripsi

dwCipherStrength

Kekuatan cipher enkripsi massal, dalam bit. Bisa menjadi salah satu nilai berikut: 0, 40, 56, 128, 168, atau 256.

aiHash

ALG_ID menunjukkan hash yang digunakan untuk membuat Kode Autentikasi Pesan (MAC). Tabel berikut ini menjelaskan konstanta yang valid untuk anggota ini.

Nilai Makna
CALG_MD5
 Algoritma hash MD5.
CALG_SHA
 Algoritma hash SHA.

dwHashStrength

Kekuatan hash, dalam bit: 128 atau 160.

aiExch

ALG_ID menunjukkan algoritma pertukaran kunci yang digunakan untuk menghasilkan rahasia master bersama. Tabel berikut ini menjelaskan konstanta yang valid untuk anggota ini.

Nilai Makna
CALG_RSA_KEYX
 Pertukaran kunci RSA.
CALG_DH_EPHEM
 Diffie-Hellman pertukaran kunci.

dwExchStrength

Panjang kunci, dalam bit. Untuk pertukaran kunci RSA, anggota ini biasanya akan berisi salah satu nilai berikut: 512, 768, 1024, atau 2048. Untuk pertukaran kunci Diffie-Hellman, anggota ini biasanya akan berisi salah satu nilai berikut: 224, 256, 384, atau 512.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header schannel.h