EnumerateSecurityPackagesW (sspi.h)

Artikel
11/20/2024

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

Sintaksis

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesW(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoW  *ppPackageInfo
);

Parameter

[in] pcPackages

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

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi akan 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.

Komentar

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

Nota

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

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	SspiCli.dll

Lihat juga

AcquireCredentialsHandle (Umum)

freecontextBuffer

Fungsi SSPI

SecPkgInfo

Bagikan melalui