Struktur SecPkgInfoA (sspi.h)

Artikel
11/20/2024

Struktur SecPkgInfo menyediakan informasi umum tentang paket keamanan , seperti nama dan kemampuannya.

Sintaksis

typedef struct _SecPkgInfoA {
  unsigned long  fCapabilities;
  unsigned short wVersion;
  unsigned short wRPCID;
  unsigned long  cbMaxToken;
  SEC_CHAR       *Name;
  SEC_CHAR       *Comment;
} SecPkgInfoA, *PSecPkgInfoA;

Anggota

fCapabilities

Set bendera bit yang menjelaskan kemampuan paket keamanan. Anggota ini bisa menjadi kombinasi dari bendera berikut.

Nilai	Arti
SECPKG_FLAG_INTEGRITY 0x1	Paket keamanan mendukung fungsi MakeSignature dan VerifySignature.
SECPKG_FLAG_PRIVACY 0x2	Paket keamanan mendukung fungsi EncryptMessage (Umum) dan DecryptMessage (Umum).
SECPKG_FLAG_TOKEN_ONLY 0x4	Paket hanya tertarik pada bagian token keamanan pesan, dan akan mengabaikan buffer lain. Ini adalah masalah terkait performa.
SECPKG_FLAG_DATAGRAM 0x8	Mendukung datagramautentikasi gaya. Untuk informasi selengkapnya, lihat SSPI Context Semantics. Important Paket Microsoft Kerberos tidak mendukung konteks datagram dalam mode pengguna ke pengguna.
SECPKG_FLAG_CONNECTION 0x10	Mendukung autentikasi gaya berorientasi koneksi. Untuk informasi selengkapnya, lihat SSPI Context Semantics.
SECPKG_FLAG_MULTI_REQUIRED 0x20	Beberapa kaki diperlukan untuk autentikasi.
SECPKG_FLAG_CLIENT_ONLY 0x40	Dukungan autentikasi server tidak disediakan.
SECPKG_FLAG_EXTENDED_ERROR 0x80	Mendukung penanganan kesalahan yang diperluas. Untuk informasi selengkapnya, lihat Informasi Kesalahan yang Diperluas .
SECPKG_FLAG_IMPERSONATION 0x100	Mendukung peniruan Windows dalam konteks server.
SECPKG_FLAG_ACCEPT_WIN32_NAME 0x200	Memahami prinsipal Windows dan nama target.
SECPKG_FLAG_STREAM 0x400	Mendukung semantik aliran. Untuk informasi selengkapnya, lihat SSPI Context Semantics.
SECPKG_FLAG_NEGOTIABLE 0X800	Dapat digunakan oleh paket keamanan Negosiasi Microsoft .
SECPKG_FLAG_GSS_COMPATIBLE 0x1000	Mendukung kompatibilitas GSS.
SECPKG_FLAG_LOGON 0x2000	MendukungLsaLogonUser .
SECPKG_FLAG_ASCII_BUFFERS 0x4000	Buffer token dalam format karakter ASCII.
SECPKG_FLAG_FRAGMENT 0x8000	Mendukung pemisahan token besar menjadi buffer yang lebih kecil sehingga aplikasi dapat melakukan panggilan berulang ke InitializeSecurityContext (Umum) dan AcceptSecurityContext (Umum) dengan buffer yang lebih kecil untuk menyelesaikan autentikasi.
SECPKG_FLAG_MUTUAL_AUTH 0x10000	Mendukung autentikasi bersama.
SECPKG_FLAG_DELEGATION 0x20000	Mendukung delegasi.
SECPKG_FLAG_READONLY_WITH_CHECKSUM 0x40000	Paket keamanan mendukung penggunaan checksum alih-alih enkripsi di tempat saat memanggil fungsi EncryptMessage.
SECPKG_FLAG_RESTRICTED_TOKENS 0x80000	Mendukung penelepon dengan token terbatas.
SECPKG_FLAG_NEGO_EXTENDER 0x00100000	Paket keamanan memperluas paket keamanan Microsoft Negosiasi. Mungkin ada paling banyak satu paket jenis ini.
SECPKG_FLAG_NEGOTIABLE2 0x00200000	Paket ini dinegosiasikan oleh paket jenis SECPKG_FLAG_NEGO_EXTENDER.
SECPKG_FLAG_APPCONTAINER_PASSTHROUGH 0x00400000	Paket ini menerima semua panggilan dari aplikasi kontainer aplikasi.
SECPKG_FLAG_APPCONTAINER_CHECKS 0x00800000	Paket ini menerima panggilan dari aplikasi kontainer aplikasi jika salah satu pemeriksaan berikut berhasil. Pemanggil memiliki kemampuan kredensial default. Targetnya adalah server proksi. Pemanggil telah menyediakan kredensial.
SECPKG_CALLFLAGS_APPCONTAINER 0x00000001	Pemanggil adalah kontainer aplikasi.
SECPKG_CALLFLAGS_AUTHCAPABLE 0x00000002	Pemanggil dapat menggunakan kredensial default.
SECPKG_CALLFLAGS_FORCE_SUPPLIED 0x00000004	Pemanggil hanya dapat menggunakan kredensial yang disediakan.

wVersion

Menentukan versi protokol paket. Harus 1.

wRPCID

Menentukan pengidentifikasi RPC DCE, jika sesuai. Jika paket tidak menerapkan salah satu sistem keamanan terdaftar DCE, nilai yang dipesan SECPKG_ID_NONE digunakan.

cbMaxToken

Menentukan ukuran maksimum, dalam byte, dari token.

Name

Penunjuk ke string null-terminated yang berisi nama paket keamanan.

Comment

Penunjuk ke string null-terminated. Ini dapat berupa string tambahan yang diteruskan kembali oleh paket.

Komentar

Nota

Header sspi.h mendefinisikan SecPkgInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	sspi.h (termasuk Security.h)

Lihat juga

EnumerateSecurityPackages

QuerySecurityPackageInfo

Bagikan melalui