Fungsi EnumerateSecurityPackagesA (sspi.h)

Artikel
03/04/2024

Fungsi EnumerateSecurityPackages mengembalikan array struktur SecPkgInfo yang memberikan informasi tentang paket keamanan yang tersedia untuk klien.

Sintaks

SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesA(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoA  *ppPackageInfo
);

Parameter

[in] pcPackages

Penunjuk ke variabel ULONG yang menerima jumlah paket yang tersedia pada sistem. Ini termasuk paket yang sudah dimuat dan paket tersedia sesuai permintaan.

[in] ppPackageInfo

Penunjuk ke variabel yang menerima penunjuk ke array struktur SecPkgInfo . Setiap struktur berisi informasi dari penyedia dukungan keamanan (SSP) yang menjelaskan kemampuan paket keamanan yang tersedia dalam SSP tersebut.

Setelah Anda selesai menggunakan array , kosongkan memori dengan memanggil fungsi FreeContextBuffer .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai	Deskripsi
SEC_E_INSUFFICIENT_MEMORY 0x80090300L	Memori tidak cukup untuk mengalokasikan satu atau beberapa buffer.
SEC_E_INVALID_HANDLE 0x80090301L	Handel yang tidak valid ditentukan.
SEC_E_SECPKG_NOT_FOUND 0x80090305L	Paket yang ditentukan tidak ditemukan.

Keterangan

Pemanggil dapat menggunakan anggota Nama struktur SecPkgInfo untuk menentukan paket keamanan dalam panggilan ke fungsi AcquireCredentialsHandle (Umum).

Catatan

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

Lihat juga

AcquireCredentialsHandle (Umum)

FreeContextBuffer

Fungsi SSPI

SecPkgInfo

Share via