Fonction FwpsOpenToken0 (fwpsk.h)

Article
02/29/2024

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

RemarqueFwpsOpenToken0 est une version spécifique de FwpsOpenToken. Pour plus d’informations , voir 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 au moteur de filtre. Un pilote de légende appelle la fonction FwpmEngineOpen0 pour ouvrir une session sur le 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 pour déterminer 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 (DACL) du jeton 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 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 status	Une erreur est survenue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 7.
Plateforme cible	Universal
En-tête	fwpsk.h (inclure Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

Voir aussi

FwpmEngineOpen0

Partager via