struktur SEC_CHANNEL_BINDINGS (sspi.h)

  • Artikel

Menentukan informasi pengikatan saluran untuk konteks keamanan.

Sintaks

typedef struct _SEC_CHANNEL_BINDINGS {
  unsigned long dwInitiatorAddrType;
  unsigned long cbInitiatorLength;
  unsigned long dwInitiatorOffset;
  unsigned long dwAcceptorAddrType;
  unsigned long cbAcceptorLength;
  unsigned long dwAcceptorOffset;
  unsigned long cbApplicationDataLength;
  unsigned long dwApplicationDataOffset;
} SEC_CHANNEL_BINDINGS, *PSEC_CHANNEL_BINDINGS;

Anggota

dwInitiatorAddrType

Jenis alamat (misalnya, HTTP) yang ditentukan untuk klien.

cbInitiatorLength

Ukuran, dalam byte, dari data yang menentukan alamat klien.

dwInitiatorOffset

Jumlah byte dari awal struktur ini hingga awal data yang menentukan alamat klien.

dwAcceptorAddrType

Jenis alamat (misalnya, SPN) yang ditentukan untuk server.

cbAcceptorLength

Ukuran, dalam byte, dari data yang menentukan alamat server.

dwAcceptorOffset

Jumlah byte dari awal struktur ini hingga awal data yang menentukan alamat server.

cbApplicationDataLength

Ukuran, dalam byte, dari data pengikatan saluran.

dwApplicationDataOffset

Ukuran, dalam byte, dari struktur ini. Data pengikatan saluran segera mengikuti struktur ini.

Keterangan

Schannel menetapkan ke nol nilai semua anggota struktur ini selain cbApplicationDataLength dan dwApplicationDataOffset.

Penyedia dukungan keamanan (SSP) selain Schannel harus menggunakan nilai struktur ini yang diperoleh melalui panggilan ke fungsi QueryContextAttributes (Schannel) untuk diteruskan sebagai struktur SecBuffer jenis SECBUFFER_CHANNEL_BINDINGS sebagai salah satu buffer dalam parameter pInput dari panggilan ke fungsi AcceptSecurityContext (Umum).

Penyedia dukungan keamanan (SSP) selain Schannel harus mendapatkan informasi pengikatan saluran yang ditentukan oleh struktur ini dengan memanggil fungsi QueryContextAttributes (Schannel) pada konteks Schannel yang digunakan klien untuk mengautentikasi. Teruskan informasi pengikatan saluran ini sebagai struktur SecBuffer jenis SECBUFFER_CHANNEL_BINDINGS ke parameter pInput panggilan ke fungsi AcceptSecurityContext (Umum).

Jika nilai parameter ulAttribute dari fungsi QueryContextAttributes (Schannel)SECPKG_ATTR_UNIQUE_BINDINGS, data pengikatan saluran yang ditentukan oleh struktur ini dimulai dengan "tls-unique:".

Jika nilai parameter ulAttribute dari fungsi QueryContextAttributes (Schannel)SECPKG_ATTR_ENDPOINT_BINDINGS, data pengikatan saluran yang ditentukan oleh struktur ini dimulai dengan "tls-server-end-point:".

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header sspi.h

Lihat juga

QueryContextAttributes (Schannel)

SecPkgContext_Bindings