Partager via

Fonction FwpsOpenToken0 (fwpsu.h)

  • Article

Ouvre un jeton d’accès.

Notes

FwpsOpenToken0 est une version spécifique de FwpsOpenToken. Pour plus d’informations, consultez Noms indépendants de la version du PAM et ciblage de versions spécifiques de Windows.

Syntaxe

DWORD FwpsOpenToken0(
  HANDLE engineHandle,
  LUID   modifiedId,
  DWORD  desiredAccess,
  HANDLE *accessToken
);

Paramètres

engineHandle

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

modifiedId

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

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 (DACL) du jeton pour déterminer quels accès sont accordés ou refusés.

accessToken

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

Valeur retournée

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

Code de retour Description
STATUS_SUCCESS Le jeton d’accès a été ouvert.
Autres codes d’état Une erreur est survenue.

Configuration requise

Condition requise Valeur
En-tête fwpsu.h