Fonction de rappel CBADMITRESULT (lpmapi.h)

La fonction cbAdmitResult est utilisée par les LPM pour retourner les résultats de la demande LPM_AdmitRsvpMsg . Les LPM ne doivent utiliser cette fonction que s’ils ont retourné LPM_RESULT_DEFER à l’appel de fonction LPM_AdmitRsvpMsg . Le PCM accepte uniquement les résultats de cette fonction dans la limite de temps de résultat établie par chaque LPM via le paramètre ResultTimeLimit de la fonction LPM_Initialize .

Syntaxe

CBADMITRESULT Cbadmitresult;

ULONG * Cbadmitresult(
  [in] LPM_HANDLE LpmHandle,
  [in] RHANDLE RequestHandle,
  [in] ULONG ulPcmActionFlags,
  [in] int LpmError,
  [in] int PolicyDecisionsCount,
  [in] POLICY_DECISION *pPolicyDecisions
)
{...}

Paramètres

[in] LpmHandle

Handle unique pour le LPM, tel que fourni dans LPM_Initialize. Le PCM ignore tout résultat qui n’est pas accompagné d’un handle LPM valide.

[in] RequestHandle

Handle unique qui distingue cette requête de toutes les autres demandes. Les LPM doivent passer ce handle au PCM lors du retour asynchrone des résultats pour une requête individuelle en appelant cbAdmitResult. Le paramètre RequestHandle devient non valide une fois les résultats retournés, ce qui oblige chaque requête à obtenir son propre RequestHandle unique à partir du PCM.

[in] ulPcmActionFlags

Indicateurs d’action du module de contrôle de stratégie.

[in] LpmError

Code d’erreur LPM. Doit prendre l'une des valeurs suivantes :

Valeur Signification
INV_LPM_HANDLE
Le handle LPM fourni n’est pas valide.
LPM_TIME_OUT
Le LPM a retourné des résultats après la limite de temps.
INV_REQ_HANDLE
Le handle de requête fourni n’est pas valide.
DUP_RESULTS
Le LPM a déjà retourné les résultats de cette demande.
INV_RESULTS
Les résultats fournis ne sont pas valides.

[in] PolicyDecisionsCount

Nombre de décisions de stratégie fournies dans pPolicyDecisions.

[in] pPolicyDecisions

Les décisions de stratégie, sous la forme d’une ou de plusieurs structures POLICY_DECISION .

Valeur retournée

Cette fonction de rappel ne retourne pas de valeur.

Remarques

Lorsqu’une demande a été rejetée, le PCM appelle le LPM pour lui demander de supprimer l’état de la demande. Le LPM peut choisir de supprimer l’état de la demande à tout moment pendant le processus de rejet. Si le LPM supprime l’état d’une requête peu après son rejet de la demande, le LPM doit être prêt à gérer les appels suivants (par le PCM, via la fonction LPM_DeleteState ) pour supprimer l’état (déjà supprimé).

Le LPM n’a pas besoin de conserver l’état des requêtes auxquelles il retourne LPV_DONT_CARE. Toutefois, le LPM doit être prêt à gérer LPM_DeleteState demandes pour cet état (inexistant).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête lpmapi.h

Voir aussi

LPM_AdmitRsvpMsg

LPM_DeleteState

LPM_Initialize