LSA_GET_AUTH_DATA_FOR_USER fungsi panggilan balik (ntsecpkg.h)

  • Artikel

Fungsi GetAuthDataForUser mengambil informasi autentikasi untuk pengguna dari database Security Accounts Manager (SAM) dan menempatkannya ke dalam format yang cocok untuk fungsi ConvertAuthDataToken .

Sintaks

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

Parameter

[in] Name

Penunjuk ke struktur UNICODE_STRING yang menentukan nama akun SAM.

[in] NameType

Nilai enumerasi SECPKG_NAME_TYPE yang menentukan jenis nama akun di Nama. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
SecNameSamCompatible
 Nama kompatibel dengan SAM. Contoh nama dalam format yang kompatibel dengan SAM adalah "ExampleDomain\Username".
SecNameAlternateId
 Nama berada di properti AltSecId dari akun SAM. Anda harus menentukan nilai untuk parameter Awalan saat menggunakan nilai ini.
SecNameFlat
 Nama adalah nama akun gaya nama prinsipal pengguna datar (UPN).
SecNameDN
 Nama adalah nama objek yang dibedakan. Untuk informasi selengkapnya, lihat Keterangan.

[in] Prefix

Penunjuk ke struktur UNICODE_STRING yang berisi awalan yang akan digunakan untuk nama yang ditentukan dengan SecNameAlternateIdNameType.

[out] UserAuthData

Pointer yang menerima alamat data yang diambil.

[out] UserAuthDataSize

Penunjuk ke ULONG yang menerima ukuran data yang diambil.

[out] UserFlatName

Arahkan ke struktur UNICODE_STRING yang menerima UPN, jika berlaku.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS yang menunjukkan alasan gagalnya.

Keterangan

Fungsi GetAuthDataForUser menggabungkan fungsi OpenSamUser, GetUserAuthData, dan CloseSamUser ke dalam satu panggilan.

Penunjuk ke fungsi-fungsi ini tersedia dalam struktur LSA_SECPKG_FUNCTION_TABLE yang diterima oleh fungsi SpInitialize .

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

CloseSamUser

GetUserAuthData

LSA_SECPKG_FUNCTION_TABLE

OpenSamUser

SpInitialize