IWDFIoRequest::Impersonate method (wudfddi.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The Impersonate method registers the interface for the method that the framework should call for impersonation.

Syntax

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

Parameters

[in] ImpersonationLevel

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

[in] pCallback

A pointer to the IImpersonateCallback interface whose method the framework calls for impersonation.

[in, optional] pvCallbackContext

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 IImpersonateCallback::OnImpersonate method. This parameter is optional. The driver can pass NULL if the driver does not have to supply a context.

Return value

Impersonate returns S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.

Remarks

For information about how UMDF and UMDF drivers handle impersonation, see Handling Impersonation.

Requirements

See also

IImpersonateCallback

IImpersonateCallback::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL