Fungsi QueryContextAttributes (CredSSP)

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 QueryContextAttributes(
  _In_  PCtxtHandle phContext,
  _In_  ULONG       ulAttribute,
  _Out_ PVOID       pBuffer
);

Parameter

phContext [in]

Handel ke konteks keamanan yang akan dikueri.

ulAttribute [in]

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 yang menentukan nama paket autentikasi yang dinegosiasikan oleh penyedia Microsoft Negotiate .
SECPKG_ATTR_PACKAGE_INFO 10	Parameter pBuffer berisi penunjuk ke struktur 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.

 

pBuffer [keluar]

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 .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Sspi.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll
Nama Unicode dan ANSI	QueryContextAttributesW (Unicode) dan QueryContextAttributesA (ANSI)

Lihat juga

Fungsi SSPI

CERT_CONTEXT

FreeContextBuffer

SecPkgContext_ClientCreds

SecPkgContext_Sizes