This topic has not yet been rated - Rate this topic

IWDFIoRequest::Impersonate method

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