Metode IWDFIoRequest::Impersonate (wudfddi.h)

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode Peniruan identitas mendaftarkan antarmuka untuk metode yang harus dipanggil kerangka kerja untuk peniruan identitas.

Sintaks

HRESULT Impersonate(
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           IImpersonateCallback         *pCallback,
  [in, optional] void                         *pvCallbackContext
);

Parameter

[in] ImpersonationLevel

Nilai jenis SECURITY_IMPERSONATION_LEVEL yang mengidentifikasi tingkat peniruan identitas.

[in] pCallback

Penunjuk ke antarmuka IImpersonateCallback yang metodenya digunakan kerangka kerja untuk peniruan identitas.

[in, optional] pvCallbackContext

Penunjuk ke buffer yang berisi informasi konteks yang terkait dengan panggilan peniruan. Kerangka kerja meneruskan informasi konteks ini dalam panggilan ke metode IImpersonateCallback::OnImpersonate . Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak harus menyediakan konteks.

Mengembalikan nilai

Meniru pengembalian S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h.

Keterangan

Untuk informasi tentang bagaimana driver UMDF dan UMDF menangani peniruan, lihat Menangani Peniruan.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Lihat juga

IImpersonateCallback

IImpersonateCallback::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL