Compartilhar via


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

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

O método Impersonate registra a interface do 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 SECURITY_IMPERSONATION_LEVELdigitado que identifica o nível de representação.

[in] pCallback

Um ponteiro para a interface IImpersonateCallback cujo método a estrutura exige 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.

Valor de retorno

Represente 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.

Observações

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

Requisitos

Requisito Valor
fim do suporte Indisponível no UMDF 2.0 e posterior.
da Plataforma de Destino Área de trabalho
versão mínima do UMDF 1.5
cabeçalho wudfddi.h (inclua Wudfddi.h)
de DLL WUDFx.dll

Consulte também

IImpersonateCallback

IImpersonateCallback::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL