Fungsi ImpersonateNamedPipeClient (namedpipeapi.h)
Fungsi ImpersonateNamedPipeClient meniru aplikasi klien pipa bernama.
Sintaks
BOOL ImpersonateNamedPipeClient(
[in] HANDLE hNamedPipe
);
Parameter
[in] hNamedPipe
Handel ke pipa bernama.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi ImpersonateNamedPipeClient memungkinkan akhir server dari pipa bernama untuk meniru akhir klien. Ketika fungsi ini dipanggil, sistem file named-pipe mengubah utas proses panggilan untuk mulai meniru konteks keamanan pesan terakhir yang dibaca dari pipa. Hanya akhir server dari pipa yang dapat memanggil fungsi ini.
Server dapat memanggil fungsi RevertToSelf ketika peniruan selesai.
- Tingkat peniruan token yang diminta kurang dari SecurityImpersonation, seperti SecurityIdentification atau SecurityAnonymous.
- Pemanggil memiliki hak istimewa SeImpersonatePrivilege .
- Proses (atau proses lain dalam sesi masuk pemanggil) membuat token menggunakan kredensial eksplisit melalui fungsi LogonUser atau LsaLogonUser .
- Identitas terautentikasi sama dengan pemanggil.
Contoh
Untuk contoh yang menggunakan fungsi ini, lihat Memverifikasi Akses Klien dengan ACL.
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 | namedpipeapi.h |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |