Fungsi SeCreateClientSecurity (ntifs.h)

  • Artikel

Rutinitas SeCreateClientSecurity menginisialisasi struktur konteks klien keamanan dengan informasi yang diperlukan untuk memanggil SeImpersonateClientEx.

Sintaks

NTSTATUS SeCreateClientSecurity(
  [in]  PETHREAD                     ClientThread,
  [in]  PSECURITY_QUALITY_OF_SERVICE ClientSecurityQos,
        BOOLEAN                      RemoteSession,
  [out] PSECURITY_CLIENT_CONTEXT     ClientContext
);

Parameter

[in] ClientThread

Arahkan ke utas klien yang akan ditiru.

[in] ClientSecurityQos

Penunjuk ke struktur SECURITY_QUALITY_OF_SERVICE yang dialokasikan penelepon yang menunjukkan bentuk peniruan yang akan dilakukan.

RemoteSession

Atur ke TRUE jika server permintaan klien bersifat jarak jauh.

[out] ClientContext

Penunjuk ke struktur SECURITY_CLIENT_CONTEXT yang dialokasikan penelepon untuk diinisialisasi.

Nilai kembali

Menampilkan kode Deskripsi
STATUS_SUCCESS Konteks klien keamanan berhasil diinisialisasi.
STATUS_BAD_IMPERSONATION_LEVEL Klien yang akan ditiru saat ini meniru kliennya sendiri, dan salah satu hal berikut ini benar: (1) Token efektif klien tidak dapat diteruskan untuk digunakan oleh server lain, karena tingkat peniruannya adalah SecurityAnonymous atau SecurityIdentification. (2) ServerIsRemote adalah TRUE, dan utas klien meniru kliennya di selain tingkat SecurityDelegation .

Keterangan

SeCreateClientSecurity menginisialisasi blok konteks keamanan klien untuk mewakili konteks keamanan klien.

Jika anggota ContextTrackingModeclientSecurityQos diatur ke SECURITY_DYNAMIC_TRACKING dan ServerIsRemote diatur ke FALSE, SeCreateClientSecurity menggunakan referensi ke token efektif klien. Jika tidak, SeCreateClientSecurity membuat salinan token klien.

Setiap panggilan ke SeCreateClientSecurity harus dicocokkan dengan panggilan berikutnya ke SeDeleteClientSecurity.

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Lihat juga

SeDeleteClientSecurity

SeImpersonateClientEx