Struktur SecBuffer (sspi.h)
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 |
---|---|
|
Buffer berisi pesan pemberitahuan. |
|
Buffer berisi bitmask untuk buffer SECBUFFER_READONLY_WITH_CHECKSUM. |
|
Buffer berisi informasi pengikatan saluran. |
|
Buffer berisi struktur DOMAIN_PASSWORD_INFORMATION . |
|
Buffer berisi data umum. Paket keamanan dapat membaca dan menulis data ini, misalnya, untuk mengenkripsi beberapa atau semuanya. |
|
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. |
|
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. |
|
Paket keamanan menggunakan nilai ini untuk menunjukkan jumlah byte tambahan atau tidak diolah dalam pesan. |
|
Buffer berisi daftar pengidentifikasi objek (OID) khusus protokol. Biasanya tidak menarik bagi penelepon. |
|
Buffer berisi tanda tangan buffer SECBUFFER_MECHLIST . Biasanya tidak menarik bagi penelepon. |
|
Paket keamanan menggunakan nilai ini untuk menunjukkan jumlah byte yang hilang dalam pesan tertentu. Anggota pvBuffer diabaikan dalam jenis ini. |
|
Ini adalah parameter khusus transportasi ke paket. Misalnya, pengalih NetWare dapat menyediakan pengidentifikasi objek server, sementara DCE RPC dapat menyediakan UUID asosiasi, dan sebagainya. |
|
Buffer berisi kunci yang dibagikan sebelumnya. Ukuran buffer PSK maksimum yang diizinkan adalah 256 byte. |
|
Buffer berisi identitas kunci yang dibagikan sebelumnya. |
|
Buffer berisi pengidentifikasi kunci master SRTP. |
|
Buffer berisi daftar profil perlindungan SRTP, dalam urutan preferensi turun. |
|
Buffer berisi header khusus protokol untuk rekaman tertentu. Biasanya tidak menarik bagi penelepon. |
|
Buffer berisi trailer khusus protokol untuk rekaman tertentu. Biasanya tidak menarik bagi penelepon. |
|
Bendera ini dicadangkan. Jangan gunakan metode tersebut. |
|
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. |
|
Buffer berisi bagian token keamanan pesan. Ini baca-saja untuk parameter input atau baca/tulis untuk parameter output. |
|
Buffer berisi versi protokol pengikatan token yang didukung dan parameter kunci, dalam urutan preferensi menurun. |
|
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.
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) |