LSA_OPEN_SAM_USER fungsi panggilan balik (ntsecpkg.h)

Mengambil handel ke akun pengguna di database Security Accounts Manager (SAM).

Sintaks

LSA_OPEN_SAM_USER LsaOpenSamUser;

NTSTATUS LsaOpenSamUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [in]  BOOLEAN AllowGuest,
  [in]  ULONG Reserved,
  [out] PVOID *UserHandle
)
{...}

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 ada di properti AltSecId dari akun SAM. Nilai ini digunakan dengan parameter Awalan .
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 menentukan awalan yang akan digunakan dengan nama yang menggunakan NameType dari SecNameAlternateId.

[in] AllowGuest

Menentukan apakah akan menggunakan akun Tamu jika akun SAM tidak ditemukan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
FALSE	Jika pengguna tidak ditemukan, panggilan fungsi OpenSamUser gagal.
TRUE	Jika pengguna tidak ditemukan dan akun Tamu diaktifkan, akun Tamu akan digunakan.

[in] Reserved

Dicadangkan. Tentukan nol.

[out] UserHandle

Penunjuk ke penunjuk yang menerima handel ke akun pengguna.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan STATUS_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah salah satu kode kesalahan NTSTATUS berikut yang menunjukkan alasan kegagalan.

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	NameType adalah SecNameAlternateId dan Awalan adalah NULL.
STATUS_NO_SUCH_USER	Akun SAM tidak dapat ditemukan.

Keterangan

Untuk menutup handel yang diterima oleh parameter UserHandle , panggil fungsi CloseSamUser .

Nama khusus pengguna mengidentifikasi nama, domain, dan jalur lengkap ke objek Direktori Aktif yang mewakili pengguna.

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

LSA_SECPKG_FUNCTION_TABLE

SpInitialize