LSA_CONVERT_AUTH_DATA_TO_TOKEN fungsi panggilan balik (ntsecpkg.h)

Artikel
08/25/2023

Fungsi ConvertAuthDataToken membuat token akses dari data otorisasi yang dikembalikan dari fungsi GetAuthDataForUser atau GetUserAuthData .

Sintaks

LSA_CONVERT_AUTH_DATA_TO_TOKEN LsaConvertAuthDataToToken;

NTSTATUS LsaConvertAuthDataToToken(
  [in]  PVOID UserAuthData,
  [in]  ULONG UserAuthDataSize,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]  PTOKEN_SOURCE TokenSource,
  [in]  SECURITY_LOGON_TYPE LogonType,
  [in]  PUNICODE_STRING AuthorityName,
  [out] PHANDLE Token,
  [out] PLUID LogonId,
  [out] PUNICODE_STRING AccountName,
  [out] PNTSTATUS SubStatus
)
{...}

Parameter

[in] UserAuthData

Arahkan ke data otorisasi yang diterima dari fungsi GetAuthDataForUser atau GetUserAuthData .

[in] UserAuthDataSize

Ukuran, dalam byte, dari data otorisasi yang ditentukan oleh parameter UserAuthData .

[in] ImpersonationLevel

Nilai SECURITY_IMPERSONATION_LEVEL yang menentukan tingkat peniruan untuk token yang akan dibuat.

[in] TokenSource

Penunjuk ke struktur TOKEN_SOURCE yang menentukan sumber yang akan direkam dalam token.

[in] LogonType

Nilai SECURITY_LOGON_TYPE yang menunjukkan jenis masuk untuk direkam dalam token.

[in] AuthorityName

Penunjuk ke struktur UNICODE_STRING yang menentukan nama otoritas yang mengizinkan pengguna ini, biasanya nama domain.

[out] Token

Penunjuk ke HANDLE yang menerima handel token pengguna.

Setelah Anda selesai menggunakan token pengguna, lepaskan handel dengan memanggil CloseHandle.

[out] LogonId

Penunjuk ke LUID yang menerima pengidentifikasi masuk untuk token.

[out] AccountName

Penunjuk ke struktur UNICODE_STRING yang menerima nama akun yang dikodekan dalam parameter UserAuthData .

[out] SubStatus

Penunjuk ke variabel yang menerima informasi tambahan tentang nilai pengembalian panggilan fungsi.

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

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