Expand Minimize

WdfRequestImpersonate method

[Applies to UMDF only]

The WdfRequestImpersonate method registers a driver-supplied event callback function that the framework should call for impersonation.

Syntax


NTSTATUS WdfRequestImpersonate(
  [in]            WDFREQUEST Request,
  [in]            SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]            PFN_WDF_REQUEST_IMPERSONATE EvtRequestImpersonate,
  [in, optional]  PVOID Context
);

Parameters

Request [in]

A handle to the framework request object that represents the I/O request that is being completed.

ImpersonationLevel [in]

A SECURITY_IMPERSONATION_LEVEL-typed value that identifies the level of impersonation.

EvtRequestImpersonate [in]

A pointer to the driver's EvtRequestImpersonate event callback function.

Context [in, optional]

A pointer to a buffer that contains context information that is related to the impersonation call. The framework passes this context information in a call to the EvtRequestImpersonate event callback function. This parameter is optional and can be NULL

Return value

If the WdfRequestImpersonate method encounters no errors, it returns STATUS_SUCCESS.

The method might return other NTSTATUS values.

Remarks

The WdfRequestImpersonate method does not return until the EvtRequestImpersonate event callback function completes.

For more information, see Handling Client Impersonation in UMDF Drivers.

Requirements

Minimum support

Windows 8.1

Minimum UMDF version

2.0

Header

Wdfrequest.h (include Wdf.h)

Library

WUDFx02000.lib

DLL

WUDFx02000.dll

IRQL

PASSIVE_LEVEL

See also

EvtRequestImpersonate
IWDFIoRequest::Impersonate

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft