Fungsi QueryContextAttributesExA (sspi.h)
Memungkinkan aplikasi transportasi untuk mengkueri paket keamanan untuk atributtertentu dari konteks keamanan.
Sintaks
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Parameter
[in] phContext
Handel ke konteks keamanan yang akan dikueri.
[in] ulAttribute
Menentukan atribut konteks yang akan dikembalikan. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_AccessToken .
Mengembalikan handel ke token akses. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_SessionAppData .
Mengembalikan atau menentukan data aplikasi untuk sesi tersebut. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Authority .
Mengkueri nama otoritas autentikasi. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_ClientSpecifiedTarget yang mewakili nama prinsipal layanan (SPN) dari target awal yang disediakan oleh klien.
Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_ConnectionInfo .
Mengembalikan informasi terperinci tentang koneksi yang dibuat. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_ClientCreds yang menentukan kredensial klien.
Jika kredensial klien adalah nama pengguna dan kata sandi, buffer adalah struktur KERB_INTERACTIVE_LOGON yang dikemas. Jika kredensial klien adalah nama pengguna dan PIN kartu pintar, buffer adalah struktur KERB_CERTIFICATE_LOGON yang dikemas. Jika kredensial klien adalah kredensial identitas online, buffer adalah struktur SEC_WINNT_AUTH_IDENTITY_EX2 marshaled. Atribut ini hanya didukung di server CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_DceInfo .
Kueri untuk data otorisasi yang digunakan oleh layanan DCE. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Bindings yang menentukan informasi pengikatan saluran.
Atribut ini hanya didukung oleh paket keamanan Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_EapKeyBlock .
Kueri untuk data kunci yang digunakan oleh protokol EAP TLS. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Flags .
Mengembalikan informasi tentang bendera konteks yang dinegosiasikan. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_IssuerListInfoEx .
Mengembalikan daftar penerbit sertifikat yang diterima oleh server. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_KeyInfo .
Mengkueri informasi tentang kunci yang digunakan dalam konteks keamanan. |
|
Parameter pBuffer berisi pointer ke struktur SecPkgContext_LastClientTokenStatus yang menentukan apakah token dari panggilan terbaru ke fungsi InitializeSecurityContext adalah token terakhir dari klien.
Nilai ini hanya didukung oleh paket keamanan Negosiasi, Kerberos, dan NTLM. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Lifespan .
Mengkueri rentang hidup konteks. |
|
Parameter pBuffer berisi penunjuk ke struktur PCCERT_CONTEXT .
Menemukan konteks sertifikat yang berisi sertifikat akhir lokal. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_LocalCredentialInfo . (Usang) Digantikan oleh SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Names .
Mengkueri nama yang terkait dengan konteks. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_NativeNames .
Mengembalikan nama utama (CNAME) dari tiket keluar. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_NegotiationInfo .
Mengembalikan informasi tentang paket keamanan yang akan digunakan dengan proses negosiasi dan status negosiasi saat ini untuk penggunaan paket tersebut. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_PackageInfo .
Mengembalikan informasi tentang SSP yang digunakan. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_PasswordExpiry .
Mengembalikan informasi kedaluwarsa kata sandi. |
|
Parameter pBuffer berisi penunjuk ke struktur PCCERT_CONTEXT .
Menemukan konteks sertifikat yang berisi sertifikat akhir yang disediakan oleh server. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke HCERTCONTEXT. Menemukan konteks sertifikat yang berisi sertifikat yang disediakan oleh penyimpanan Akar. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_SessionKey .
Mengembalikan informasi tentang kunci sesi. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_SessionInfo .
Mengembalikan informasi tentang sesi. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Sizes .
Mengkueri ukuran struktur yang digunakan dalam fungsi per pesan. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_StreamSizes .
Mengkueri ukuran berbagai bagian aliran yang digunakan dalam fungsi per pesan. Atribut ini hanya didukung oleh paket keamanan Schannel. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_SubjectAttributes .
Nilai ini mengembalikan informasi tentang atribut keamanan untuk koneksi. Nilai ini hanya didukung di server CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_SupportedSignatures .
Nilai ini mengembalikan informasi tentang jenis tanda tangan yang didukung untuk koneksi. Nilai ini hanya didukung oleh paket keamanan Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_TargetInformation .
Mengembalikan informasi tentang nama server jarak jauh. |
|
Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Bindings yang menentukan informasi pengikatan saluran.
Nilai ini hanya didukung oleh paket keamanan Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung. |
[out] pBuffer
Penunjuk ke struktur yang menerima atribut. Jenis struktur yang menunjuk ke tergantung pada nilai yang ditentukan dalam parameter ulAttribute .
[in] cbBuffer
Ukuran, dalam byte, dari parameter pBuffer .
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah SEC_E_OK.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol.
Keterangan
Catatan
Header sspi.h mendefinisikan QueryContextAttributesEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | sspi.h (termasuk Security.h) |
Pustaka | Secur32.lib |
DLL | Secur32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk