Função WdfRequestImpersonate (wdfrequest.h)
[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 |