Fonction de rappel CBADMITRESULT (lpmapi.h)

  • Article
  • 2 minutes de lecture

La fonction cbAdmitResult est utilisée par les LPM pour retourner les résultats de la requête LPM_AdmitRsvpMsg . Les modules LPM doivent utiliser cette fonction uniquement 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 qu’il est 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 requêtes. Les modules LPM doivent transmettre 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 que les résultats sont 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é les 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 pour cette requête.
INV_RESULTS
 Les résultats fournis ne sont pas valides.

[in] PolicyDecisionsCount

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

[in] pPolicyDecisions

Décisions de stratégie, sous la forme d’une ou plusieurs structures de 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 demande 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é).

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

Configuration requise

   
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