Fungsi QueryCredentialsAttributesA (sspi.h)

Artikel
08/26/2023

Mengambil atribut kredensial, seperti nama yang terkait dengan kredensial. Informasi ini valid untuk konteks keamanan apa pun yang dibuat dengan kredensial yang ditentukan.

Sintaks

SECURITY_STATUS SEC_ENTRY QueryCredentialsAttributesA(
  [in]  PCredHandle   phCredential,
  [in]  unsigned long ulAttribute,
  [out] void          *pBuffer
);

Parameter

[in] phCredential

Handel kredensial yang akan dikueri.

[in] ulAttribute

Menentukan atribut yang akan dikueri. Parameter ini dapat berupa salah satu atribut berikut.

Nilai	Makna
SECPKG_CRED_ATTR_CERT	Mengembalikan thumbprint sertifikat dalam pbuffer jenis SecPkgCredentials_Cert. Atribut ini hanya didukung oleh Kerberos. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Atribut ini tidak tersedia.
SECPKG_CRED_ATTR_NAMES	Mengembalikan nama kredensial dalam pbuffer jenis SecPkgCredentials_Names. Atribut ini tidak didukung oleh Schannel dalam mode WOW64.
SECPKG_ATTR_SUPPORTED_ALGS	Mengembalikan algoritma yang didukung dalam pbuffer jenis SecPkgCred_SupportedAlgs. Semua algoritma yang didukung disertakan, terlepas dari apakah algoritma tersebut didukung oleh sertifikat yang disediakan atau diaktifkan di komputer lokal. Atribut ini hanya didukung oleh Schannel.
SECPKG_ATTR_CIPHER_STRENGTHS	Mengembalikan kekuatan cipher dalam pbuffer jenis SecPkgCred_CipherStrengths. Atribut ini hanya didukung oleh Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Mengembalikan algoritma yang didukung dalam pbuffer jenis SecPkgCred_SupportedProtocols. Semua protokol yang didukung disertakan, terlepas dari apakah protokol tersebut didukung oleh sertifikat yang disediakan atau diaktifkan di komputer lokal. Atribut ini hanya didukung oleh Schannel.

[out] pBuffer

Pointer ke buffer yang menerima atribut yang diminta. Jenis struktur yang dikembalikan tergantung pada nilai ulAttribute.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah SEC_E_OK.

Jika fungsi gagal, nilai yang dikembalikan mungkin merupakan salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
SEC_E_INVALID_HANDLE	Handel yang diteruskan ke fungsi tidak valid.
SEC_E_UNSUPPORTED_FUNCTION	Atribut yang ditentukan tidak didukung oleh Schannel. Nilai pengembalian ini hanya akan dikembalikan ketika Schannel SSP sedang digunakan.
SEC_E_INSUFFICIENT_MEMORY	Memori yang tersedia tidak cukup untuk menyelesaikan permintaan.

Keterangan

Fungsi QueryCredentialsAttributes memungkinkan aplikasi menentukan beberapa karakteristik kredensial, termasuk nama yang terkait dengan kredensial yang ditentukan.

Mengkueri atribut SECPKG_ATTR_CIPHER_STRENGTHS mengembalikan struktur SecPkgCred_CipherStrengths . Kekuatan sandi dalam struktur ini sama dengan kekuatan sandi dalam struktur SCH_CREDENTIALS yang digunakan ketika kredensial dibuat.

Catatan Aplikasi dapat menemukan kekuatan cipher default sistem dengan mengkueri atribut ini dengan kredensial default. Kredensial default dibuat dengan memanggil AcquireCredentialsHandle dengan parameter pAuthDataNULL.

Mengkueri atribut SECPKG_ATTR_SUPPORTED_ALGS mengembalikan struktur SecPkgCred_SupportedAlgs . Algoritma dalam struktur ini kompatibel dengan yang ditunjukkan dalam struktur SCH_CREDENTIALS yang digunakan saat kredensial dibuat.

Mengkueri atribut SECPKG_ATTR_SUPPORTED_PROTOCOLS mengembalikan struktur SecPkgCred_SupportedProtocols yang berisi array bit yang kompatibel dengan bidang grbitEnabledProtocols dari struktur SCH_CREDENTIALS .

Pemanggil harus mengalokasikan struktur yang diarahkan oleh parameter pBuffer . Paket keamanan mengalokasikan buffer untuk penunjuk apa pun yang dikembalikan dalam struktur pBuffer. Pemanggil dapat memanggil fungsi FreeContextBuffer untuk membebaskan pointer apa pun yang dialokasikan oleh paket keamanan.

Catatan

Header sspi.h mendefinisikan QueryCredentialsAttributes 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