Fungsi QueryContextAttributesA (sspi.h)

Artikel
08/26/2023

Fungsi QueryContextAttributes (CredSSP) memungkinkan aplikasi transportasi mengkueri paket keamanan Penyedia Dukungan Keamanan Kredensial (CredSSP) untuk atribut tertentu dari konteks keamanan.

Sintaks

SECURITY_STATUS SEC_ENTRY QueryContextAttributesA(
  [in]  PCtxtHandle   phContext,
  [in]  unsigned long ulAttribute,
  [out] void          *pBuffer
);

Parameter

[in] phContext

Handel ke konteks keamanan yang akan dikueri.

[in] ulAttribute

Atribut konteks yang akan dikembalikan. Parameter ini bisa menjadi salah satu nilai berikut. Kecuali ditentukan lain, atribut berlaku untuk klien dan server.

Nilai	Makna
SECPKG_ATTR_C_ACCESS_TOKEN 0x80000012	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_AccessToken yang menentukan token akses untuk konteks keamanan saat ini. Atribut ini hanya didukung pada server.
SECPKG_ATTR_C_FULL_ACCESS_TOKEN 0x80000082	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_AccessToken yang menentukan token akses untuk konteks keamanan saat ini. Atribut ini hanya didukung pada server.
SECPKG_ATTR_CERT_TRUST_STATUS 0x80000084	Parameter pBuffer berisi penunjuk ke struktur CERT_TRUST_STATUS yang menentukan informasi kepercayaan tentang sertifikat. Atribut ini hanya didukung pada klien.
SECPKG_ATTR_CREDS 0x80000080	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_ClientCreds yang menentukan kredensial klien. Kredensial klien dapat berupa nama pengguna dan kata sandi atau nama pengguna dan PIN kartu pintar. Atribut ini hanya didukung pada server.
SECPKG_ATTR_CREDS_2 0x80000086	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 yang di-marshalasikan. 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.
SECPKG_ATTR_NEGOTIATION_PACKAGE 0x80000081	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_PackageInfo">SecPkgContext_PackageInfo yang menentukan nama paket autentikasi yang dinegosiasikan oleh penyedia Microsoft Negotiate .
SECPKG_ATTR_PACKAGE_INFO 10	Parameter pBuffer berisi penunjuk ke struktur >SecPkgContext_PackageInfo"SecPkgContext_PackageInfo . Mengembalikan informasi tentang SSP yang digunakan.
SECPKG_ATTR_SERVER_AUTH_FLAGS 0x80000083	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Flags yang menentukan informasi tentang bendera dalam konteks keamanan saat ini. Atribut ini hanya didukung pada klien.
SECPKG_ATTR_SIZES 0x0	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_Sizes . Mengkueri ukuran struktur yang digunakan dalam fungsi per pesan dan pertukaran autentikasi.
SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES 124	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.

[out] pBuffer

Penunjuk ke struktur yang menerima atribut. Jenis struktur tergantung pada nilai parameter ulAttribute .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi dapat mengembalikan kode kesalahan berikut.

Mengembalikan kode/nilai	Deskripsi
SEC_E_INVALID_HANDLE 0x80100003	Fungsi gagal. Parameter phContext menentukan handel ke konteks yang tidak lengkap.
SEC_E_UNSUPPORTED_FUNCTION 0x80090302	Fungsi gagal. Nilai parameter ulAttribute tidak valid.

Keterangan

Struktur yang ditujukkan oleh parameter pBuffer bervariasi tergantung pada atribut yang dikueri.

Meskipun pemanggil harus mengalokasikan struktur pBuffer itu sendiri, SSP mengalokasikan memori apa pun yang diperlukan untuk menahan anggota berukuran variabel dari struktur pBuffer . Memori yang dialokasikan oleh SSP harus dikosongkan dengan memanggil fungsi FreeContextBuffer .

Catatan

Header sspi.h mendefinisikan QueryContextAttributes 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 Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	sspi.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll

Lihat juga

CERT_CONTEXT

FreeContextBuffer

Fungsi SSPI

SecPkgContext_ClientCreds

SecPkgContext_Sizes

Bagikan melalui