Struktur SecBuffer (sspi.h)

  • Artikel

Struktur SecBuffer menjelaskan buffer yang dialokasikan oleh aplikasi transportasi untuk diteruskan ke paket keamanan.

Sintaks

typedef struct _SecBuffer {
  unsigned long cbBuffer;
  unsigned long BufferType;
#if ...
  char          *pvBuffer;
#else
  void SEC_FAR  *pvBuffer;
#endif
} SecBuffer, *PSecBuffer;

Anggota

cbBuffer

Menentukan ukuran, dalam byte, dari buffer yang diacu oleh anggota pvBuffer .

BufferType

Bendera bit yang menunjukkan jenis buffer. BufferType harus menjadi salah satu bendera berikut.

Nilai Makna
SECBUFFER_ALERT
17 (0x11)
 Buffer berisi pesan pemberitahuan.
SECBUFFER_ATTRMASK
4026531840 (0xF0000000)
 Buffer berisi bitmask untuk buffer SECBUFFER_READONLY_WITH_CHECKSUM.
SECBUFFER_CHANNEL_BINDINGS
14 (0xE)
 Buffer berisi informasi pengikatan saluran.
SECBUFFER_CHANGE_PASS_RESPONSE
15 (0xF)
 Buffer berisi struktur DOMAIN_PASSWORD_INFORMATION .
SECBUFFER_DATA
1 (0x1)
 Buffer berisi data umum. Paket keamanan dapat membaca dan menulis data ini, misalnya, untuk mengenkripsi beberapa atau semuanya.
SECBUFFER_DTLS_MTU
24 (0x18)
 Buffer berisi pengaturan untuk ukuran unit transmisi maksimum (MTU) hanya untuk DTLS. Nilai defaultnya adalah 1096 dan rentang yang dapat dikonfigurasi yang valid adalah antara 200 dan 64*1024.
SECBUFFER_EMPTY
0 (0x0)
 Ini adalah tempat penampung dalam array buffer. Penelepon dapat menyediakan beberapa entri tersebut dalam array, dan paket keamanan dapat mengembalikan informasi di dalamnya. Untuk informasi selengkapnya, lihat Semantik Konteks SSPI.
SECBUFFER_EXTRA
5 (0x5)
 Paket keamanan menggunakan nilai ini untuk menunjukkan jumlah byte tambahan atau tidak diolah dalam pesan.
SECBUFFER_MECHLIST
11 (0xB)
 Buffer berisi daftar pengidentifikasi objek (OID) khusus protokol. Biasanya tidak menarik bagi penelepon.
SECBUFFER_MECHLIST_SIGNATURE
12 (0xC)
 Buffer berisi tanda tangan buffer SECBUFFER_MECHLIST . Biasanya tidak menarik bagi penelepon.
SECBUFFER_MISSING
4 (0x4)
 Paket keamanan menggunakan nilai ini untuk menunjukkan jumlah byte yang hilang dalam pesan tertentu. Anggota pvBuffer diabaikan dalam jenis ini.
SECBUFFER_PKG_PARAMS
3 (0x3)
 Ini adalah parameter khusus transportasi ke paket. Misalnya, pengalih NetWare dapat menyediakan pengidentifikasi objek server, sementara DCE RPC dapat menyediakan UUID asosiasi, dan sebagainya.
SECBUFFER_PRESHARED_KEY
22 (0x16)
 Buffer berisi kunci yang dibagikan sebelumnya. Ukuran buffer PSK maksimum yang diizinkan adalah 256 byte.
SECBUFFER_PRESHARED_KEY_IDENTITY
23 (0x17)
 Buffer berisi identitas kunci yang dibagikan sebelumnya.
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER
20 (0x14)
 Buffer berisi pengidentifikasi kunci master SRTP.
SECBUFFER_SRTP_PROTECTION_PROFILES
19 (0x13)
 Buffer berisi daftar profil perlindungan SRTP, dalam urutan preferensi turun.
SECBUFFER_STREAM_HEADER
7 (0x7)
 Buffer berisi header khusus protokol untuk rekaman tertentu. Biasanya tidak menarik bagi penelepon.
SECBUFFER_STREAM_TRAILER
6 (0x6)
 Buffer berisi trailer khusus protokol untuk rekaman tertentu. Biasanya tidak menarik bagi penelepon.
SECBUFFER_TARGET
13 (0xD)
 Bendera ini dicadangkan. Jangan gunakan metode tersebut.
SECBUFFER_TARGET_HOST
16 (0x10)
 Buffer menentukan nama prinsipal layanan (SPN) dari target.

Nilai ini didukung oleh paket keamanan Digest saat digunakan dengan pengikatan saluran.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung.
SECBUFFER_TOKEN
2 (0x2)
 Buffer berisi bagian token keamanan pesan. Ini baca-saja untuk parameter input atau baca/tulis untuk parameter output.
SECBUFFER_TOKEN_BINDING
21 (0x15)
 Buffer berisi versi protokol pengikatan token yang didukung dan parameter kunci, dalam urutan preferensi menurun.
SECBUFFER_APPLICATION_PROTOCOLS
18
 Buffer berisi daftar ID protokol aplikasi, satu daftar per jenis ekstensi negosiasi protokol aplikasi yang akan diaktifkan.
 

Selain itu, BufferType dapat menggabungkan bendera berikut dengan salah satu bendera dalam tabel sebelumnya dengan menggunakan operasi bitwise-OR.

Nilai Makna
SECBUFFER_READONLY
2147483648 (0x80000000)
 Buffer bersifat baca-saja tanpa checksum. Bendera ini ditujukan untuk mengirim informasi header ke paket keamanan untuk menghitung checksum. Paket dapat membaca buffer ini, tetapi tidak dapat mengubahnya.
SECBUFFER_READONLY_WITH_CHECKSUM
268435456 (0x10000000)
 Buffer bersifat baca-saja dengan checksum.

pvBuffer

Penunjuk ke buffer.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 R2 [hanya aplikasi desktop]
Header sspi.h (termasuk Security.h)

Lihat juga

SecBufferDesc