EVT_WDF_REQUEST_IMPERSONATE função de retorno de chamada (wdfrequest.h)
[Aplica-se somente ao UMDF]
A função de retorno de chamada de evento EvtRequestImpersonate de um driver executa tarefas no nível de representação solicitado, como abrir um arquivo protegido.
Sintaxe
EVT_WDF_REQUEST_IMPERSONATE EvtWdfRequestImpersonate;
void EvtWdfRequestImpersonate(
[in] WDFREQUEST Request,
[in, optional] PVOID Context
)
{...}
Parâmetros
[in] Request
Um identificador para um objeto de solicitação de estrutura que representa a solicitação de E/S que requer representação.
[in, optional] Context
Um ponteiro para um contexto que foi fornecido anteriormente no método WdfRequestImpersonate . Esse parâmetro é opcional e pode ser NULL se um contexto não for necessário.
Retornar valor
Nenhum
Comentários
User-Mode Driver Framework (UMDF) não permite que a função de retorno de chamada EvtRequestImpersonate de um driver chame qualquer um dos métodos de objeto da estrutura. Isso garante que o driver não exponha o nível de representação para outras funções de retorno de chamada de driver ou outros drivers.
O tipo de função EVT_WDF_REQUEST_IMPERSONATE é definido no arquivo de cabeçalho Wdfrequest.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a _Use_decl_annotations_ anotação à sua definição de função. A _Use_decl_annotations_ anotação garante que as anotações aplicadas ao tipo de função EVT_WDF_REQUEST_IMPERSONATE no arquivo de cabeçalho sejam usadas.
As seguintes restrições também se aplicam:
Quando o driver chama WdfRequestImpersonate com
ImpersonationLevel = SecurityIdentification, o retorno de chamada não pode chamar LoadLibrary ou executar qualquer ação que exija um acesso marcar.O mesmo princípio se aplica à carga de atraso de DLL. Considere um exemplo no qual o driver representa no nível de identificação e o retorno de chamada chama GetUserNameW. Como essa API, por sua vez, atrasa o carregamento de outra DLL e chama GetUserNameExW, a chamada inicial pode falhar com ERROR_PROC_NOT_FOUND ou ERROR_BAD_IMPERSONATION_LEVEL. Nesse caso, o retorno de chamada deve chamar GetUserNameExW diretamente.
Para obter mais informações, consulte Manipulando a representação do cliente em drivers UMDF.
Exemplos
Para definir uma função de retorno de chamada EvtRequestImpersonate , primeiro você deve fornecer uma declaração de função que identifique o tipo de função de retorno de chamada que você está definindo. O Windows fornece um conjunto de tipos de função de retorno de chamada para drivers. Declarar uma função usando os tipos de função de retorno de chamada ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.
Por exemplo, para definir uma função de retorno de chamada EvtRequestImpersonate chamada MyRequestImpersonate, use o tipo EVT_WDF_REQUEST_IMPERSONATE conforme mostrado neste exemplo de código:
EVT_WDF_REQUEST_IMPERSONATE MyRequestImpersonate;
Em seguida, implemente a função de retorno de chamada da seguinte maneira:
_Use_decl_annotations_
VOID
MyRequestImpersonate (
WDFREQUEST Request
PVOID Context
)
{...}
Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função para drivers KMDF.
Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.
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) |