IWDFIoRequest::Impersonate method

[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

ImpersonationLevel [in]

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

pCallback [in]

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

pvCallbackContext [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 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

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFIoRequest
IImpersonateCallback
IImpersonateCallback::OnImpersonate
SECURITY_IMPERSONATION_LEVEL

 

 

Send comments about this topic to Microsoft

Show: