Fungsi AuthzInitializeContextFromToken (authz.h)

Artikel
02/26/2024

Fungsi AuthzInitializeContextFromToken menginisialisasi konteks otorisasi klien dari token kernel. Token kernel harus telah dibuka untuk TOKEN_QUERY.

Dimulai dengan Windows Server 2012 dan Windows 8, fungsi ini juga dapat menyalin grup perangkat, klaim pengguna, dan klaim perangkat.

Sintaks

AUTHZAPI BOOL AuthzInitializeContextFromToken(
  [in]           DWORD                         Flags,
  [in]           HANDLE                        TokenHandle,
  [in]           AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
  [in, optional] PLARGE_INTEGER                pExpirationTime,
  [in]           LUID                          Identifier,
  [in, optional] PVOID                         DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE  phAuthzClientContext
);

Parameter

[in] Flags

Disiapkan untuk penggunaan masa mendatang.

[in] TokenHandle

Handel ke token klien yang digunakan untuk menginisialisasi parameter pAuthzClientContext . Token harus dibuka dengan akses TOKEN_QUERY.

[in] hAuthzResourceManager

Handel ke manajer sumber daya yang membuat konteks klien ini. Handel ini disimpan dalam struktur konteks klien.

[in, optional] pExpirationTime

Tanggal dan waktu kedaluwarsa token. Jika tidak ada nilai yang diteruskan, token tidak pernah kedaluwarsa. Waktu kedaluwarsa saat ini tidak diberlakukan.

[in] Identifier

Pengidentifikasi yang khusus untuk manajer sumber daya. Parameter ini saat ini tidak digunakan.

[in, optional] DynamicGroupArgs

Pointer ke parameter yang akan diteruskan ke fungsi panggilan balik yang menghitung grup dinamis.

[out] phAuthzClientContext

Penunjuk ke handel AuthzClientContext dikembalikan. Panggil AuthzFreeContext setelah selesai dengan konteks klien.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini memanggil fungsi panggilan balik AuthzComputeGroupsCallback untuk menambahkan pengidentifikasi keamanan ke konteks yang baru dibuat.

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	authz.h
Pustaka	Authz.lib
DLL	Authz.dll
Redistribusi	Paket Alat Administrasi Windows Server 2003 di Windows XP

Lihat juga

AuthzFreeContext

Fungsi Access Control Dasar

Bagikan melalui