Função FwpsOpenToken0 (fwpsk.h)

Artigo
02/29/2024

A função FwpsOpenToken0 abre um token de acesso.

ObservaçãoFwpsOpenToken0 é uma versão específica do FwpsOpenToken. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Sintaxe

NTSTATUS FwpsOpenToken0(
  [in]  IN HANDLE  engineHandle,
  [in]  IN LUID    modifiedId,
  [in]  IN DWORD   desiredAccess,
  [out] OUT HANDLE *accessToken
);

Parâmetros

[in] engineHandle

Um identificador para uma sessão aberta para o mecanismo de filtro. Um driver de texto explicativo chama a função FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.

[in] modifiedId

Especifica um LUID que é alterado sempre que o token é modificado. Um aplicativo pode usar esse valor como um teste de se um contexto de segurança foi alterado desde que foi usado pela última vez.

[in] desiredAccess

ACCESS_MASK estrutura que especifica os tipos de acesso solicitados ao token de acesso. Esses tipos de acesso solicitados são comparados com a DACL (lista de controle de acesso discricionário) do token para determinar quais acessos são concedidos ou negados.

[out] accessToken

Ponteiro para uma variável alocada pelo chamador que recebe um identificador para o token de acesso recém-aberto.

Retornar valor

A função FwpsOpenToken0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O token de acesso foi aberto com êxito.
Outros códigos de status	Ocorreu um erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 7.
Plataforma de Destino	Universal
Cabeçalho	fwpsk.h (inclua Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

Confira também

FwpmEngineOpen0