Fungsi QueryCredentialsAttributesA (sspi.h)

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

Sintaksis

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 untuk dikueri. Parameter ini dapat berupa salah satu atribut berikut.

Nilai Arti
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 sandi 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

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

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah SEC_E_OK.

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

Mengembalikan 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.

Komentar

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 NULLpAuthData.
 
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.

Nota

Header sspi.h mendefinisikan QueryCredentialsAttributes sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target Windows
Header sspi.h (termasuk Security.h)
Pustaka Secur32.lib
DLL Secur32.dll

Lihat juga

acquireCredentialsHandle

freecontextBuffer

SCH_CREDENTIALS

Fungsi SSPI

SecPkgCred_CipherStrengths

SecPkgCred_SupportedAlgs

SecPkgCred_SupportedProtocols

SecPkgCredentials_Names

  • Last updated on