FwpsOpenToken0, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsOpenToken0 ouvre un jeton d’accès.

Remarque FwpsOpenToken0 est une version spécifique de FwpsOpenToken. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

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

Paramètres

[in] engineHandle

Handle pour une session ouverte sur le moteur de filtre. Un pilote de légende appelle la fonction FwpmEngineOpen0 pour ouvrir une session au moteur de filtre.

[in] modifiedId

Spécifie un LUID qui change chaque fois que le jeton est modifié. Une application peut utiliser cette valeur comme test de savoir si un contexte de sécurité a changé depuis sa dernière utilisation.

[in] desiredAccess

ACCESS_MASK structure spécifiant les types d’accès demandés au jeton d’accès. Ces types d’accès demandés sont comparés à la liste de contrôle d’accès discrétionnaire du jeton (DACL) pour déterminer quels accès sont accordés ou refusés.

[out] accessToken

Pointeur vers une variable allouée par l’appelant qui reçoit un handle vers le jeton d’accès nouvellement ouvert.

Valeur de retour

La fonction FwpsOpenToken0 retourne l’un des codes NTSTATUS suivants.

Retourner le code	Description
STATUS_SUCCESS	Le jeton d’accès a été correctement ouvert.
Autres codes d’état	Une erreur s’est produite.

Remarques

Le processus qui appelle fwpsopentoken0 doit avoir le privilège SE_DEBUG_NAME activé dans son jeton de processus.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 7.
plateforme cible	Universel
d’en-tête	fwpsk.h (include Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

Voir aussi

FwpmEngineOpen0

Partager via