Fungsi panggilan balik SpGetCredentialsFn (ntsecpkg.h)

  • Artikel

Fungsi SpGetCredentials mengambil kredensialutama dan tambahan dari objek pengguna.

Sintaks

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Parameter

[in] CredentialHandle

Handel ke kredensial yang akan diambil.

[out] Credentials

Penunjuk ke struktur SecBuffer yang menerima kredensial.

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

Jika fungsi gagal, kembalikan kode NTSTATUS yang menunjukkan alasan gagalnya. Berikut ini mencantumkan alasan umum kegagalan dan kode kesalahan yang harus dikembalikan fungsi.

Menampilkan kode Deskripsi
SEC_E_INSUFFICIENT_MEMORY
 Memori tidak cukup untuk mengambil kredensial.
SEC_E_INVALID_HANDLE
 Handel tidak valid.

Keterangan

SSP/APs harus mengimplementasikan fungsi SpGetCredentials ; namun, nama aktual yang diberikan untuk implementasi terserah pengembang.

Penunjuk ke fungsi SpGetCredentials tersedia dalam struktur SECPKG_FUNCTION_TABLE yang diterima dari fungsi SpLsaModeInitialize .

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 ntsecpkg.h

Lihat juga

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize