Método IWDFIoRequest::Impersonate (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método Impersonate registra a interface para o método que a estrutura deve chamar para representação.

Sintaxe

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

Parâmetros

[in] ImpersonationLevel

Um valor de tipo SECURITY_IMPERSONATION_LEVEL que identifica o nível de representação.

[in] pCallback

Um ponteiro para a interface IImpersonateCallback cujo método a estrutura chama para representação.

[in, optional] pvCallbackContext

Um ponteiro para um buffer que contém informações de contexto relacionadas à chamada de representação. A estrutura passa essas informações de contexto em uma chamada para o método IImpersonateCallback::OnImpersonate . Esse parâmetro é opcional. O driver poderá passar NULL se o driver não precisar fornecer um contexto.

Retornar valor

A representação retornará S_OK se a operação for bem-sucedida. Caso contrário, esse método retornará um dos códigos de erro definidos em Winerror.h.

Comentários

Para obter informações sobre como os drivers UMDF e UMDF lidam com a representação, consulte Manipulando a representação.

Requisitos

Requisito	Valor
Fim do suporte	Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino	Área de Trabalho
Versão mínima do UMDF	1.5
Cabeçalho	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Confira também

IImpersonateCallback

IImpersonateCallback::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL