Fungsi SetCredentialsAttributesA (sspi.h)

Artikel
03/08/2023

Mengatur 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 SetCredentialsAttributesA(
  [in] PCredHandle   phCredential,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
       unsigned long cbBuffer
);

Parameter

[in] phCredential

Handel kredensial yang akan diatur.

[in] ulAttribute

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

Nilai	Makna
SECPKG_CRED_ATTR_NAMES	Mengatur nama kredensial dalam parameter pBuffer jenis SecPkgCredentials_Names. Atribut ini tidak didukung oleh Schannel dalam mode WOW64.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Mengatur pengaturan proksi Kerberos dalam parameter pBuffer jenis SecPkgCredentials_KdcProxySettings. Atribut ini hanya didukung oleh Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Mengatur algoritma yang didukung dalam parameter 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	Mengatur kekuatan cipher dalam parameter pBuffer jenis SecPkgCred_CipherStrengths. Atribut ini hanya didukung oleh Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Mengatur algoritma yang didukung dalam parameter 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.

[in] pBuffer

Penunjuk ke buffer yang berisi nilai atribut baru. Jenis struktur yang dikembalikan tergantung pada nilai ulAttribute.

cbBuffer

Ukuran, dalam byte, dari buffer pBuffer .

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 tidak cukup tersedia untuk menyelesaikan permintaan.

Keterangan

Catatan

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