Fungsi QueryContextAttributesA (sspi.h)

  • Artikel

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