Fungsi panggilan balik SpGetUserInfoFn (ntsecpkg.h)

  • Artikel

Fungsi SpGetUserInfo mengambil informasi tentang sesi masuk.

Sintaks

SpGetUserInfoFn Spgetuserinfofn;

NTSTATUS Spgetuserinfofn(
  [in]  PLUID LogonId,
  [in]  ULONG Flags,
  [out] PSecurityUserData *UserData
)
{...}

Parameter

[in] LogonId

Penunjuk ke LUID yang berisi sesi masuk yang informasinya akan diambil.

[in] Flags

Menentukan panjang nama domain yang dapat diterima sebagai salah satu nilai berikut.

Nilai Makna
NO_LONG_NAMES
 Nama domain yang dikembalikan tidak boleh lebih panjang dari 15 karakter.
UNDERSTANDS_LONG_NAMES
 Nama domain yang dikembalikan bisa lebih panjang dari 15 karakter.

[out] UserData

Penunjuk ke penunjuk ke struktur SecurityUserData . Jika panggilan fungsi berhasil, informasi pengguna dikembalikan dalam struktur ini. Paket keamanan harus mengalokasikan memori untuk struktur ini di ruang alamat penelepon. Pemanggil bertanggung jawab untuk membebaskan buffer dengan memanggil fungsi FreeContextBuffer .

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

Jika fungsi gagal, kembalikan kode NTSTATUS yang menunjukkan alasan gagalnya.

Keterangan

Nilai Bendera NO_LONG_NAMES memberikan kompatibilitas dengan Microsoft NTLM.

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

Penunjuk ke fungsi SpGetUserInfo 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

FreeContextBuffer

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize