Função WdfRequestImpersonate (wdfrequest.h)

  • Artigo

[Aplica-se somente ao UMDF]

O método WdfRequestImpersonate registra uma função de retorno de chamada de evento fornecida pelo driver que a estrutura deve chamar para representação.

Sintaxe

NTSTATUS WdfRequestImpersonate(
  [in]           WDFREQUEST                   Request,
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           PFN_WDF_REQUEST_IMPERSONATE  EvtRequestImpersonate,
  [in, optional] PVOID                        Context
);

Parâmetros

[in] Request

Um identificador para o objeto de solicitação de estrutura que representa a solicitação de E/S que está sendo concluída.

[in] ImpersonationLevel

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

[in] EvtRequestImpersonate

Um ponteiro para a função de retorno de chamada de evento EvtRequestImpersonate do driver.

[in, optional] Context

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 a função de retorno de chamada de evento EvtRequestImpersonate . Esse parâmetro é opcional e pode ser NULL

Retornar valor

Se o método WdfRequestImpersonate não encontrar erros, ele retornará STATUS_SUCCESS.

O método pode retornar outros valores NTSTATUS.

Comentários

O método WdfRequestImpersonate não retorna até que a função de retorno de chamada de evento EvtRequestImpersonate seja concluída.

Para obter mais informações, consulte Manipulando a representação do cliente em drivers UMDF.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1
Plataforma de Destino Universal
Versão mínima do UMDF 2,0
Cabeçalho wdfrequest.h (inclua Wdf.h)
Biblioteca WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Confira também

EvtRequestImpersonate

IWDFIoRequest::Impersonate