fonction LPM_Initialize (lpmapi.h)
La fonction LPM_Initialize initialise un module de stratégie locale (LPM). Cela se produit lorsque le service de contrôle d’admission doit effectuer un contrôle d’admission basé sur des stratégies, par exemple lorsqu’un SBM devient le gestionnaire de bande passante de sous-réseau désigné (SGBD). Les LPMs doivent s’initialiser de façon synchrone avant de retourner.
Syntaxe
ULONG LPM_Initialize(
[in] LPM_HANDLE LpmHandle,
[in] LPM_INIT_INFO *pLpmInitInfo,
[out] DWORD *pLpmVersionNumber,
[out] PETYPE *pSupportedPeType,
[out] VOID *Reserved
);
Paramètres
[in] LpmHandle
Handle unique pour le LPM, affecté par le PCM.
[in] pLpmInitInfo
Pointeur vers une structure LPM_INIT_INFO contenant des informations d’initialisation LPM.
[out] pLpmVersionNumber
Version de LPM demandée.
[out] pSupportedPeType
Type d’élément de stratégie valide (PE) utilisé par le LPM pour prendre des décisions de contrôle d’admission basées sur des stratégies. Chaque LPM ne peut prendre en charge qu’un seul type PE, bien que les versions futures puissent autoriser un LPM à prendre en charge plusieurs types PE. Les types PE réservés sont définis dans Lpmapi.h. Pour plus d’informations sur les types d’éléments de stratégie, consultez Éléments de stratégie.
Il est possible pour une dll unique de prendre en charge plusieurs types PE en utilisant le nom DE DLL entré plusieurs fois dans les données de configuration PCM. Dans ces circonstances, le PCM charge et appelle la même routine LPM_Initialize plusieurs fois; c’est la responsabilité de LPM de retourner différents types PE pour ces appels supplémentaires.
Les LPMs peuvent retourner un type PE spécial, LPM_ALL_PE_TYPES, pour indiquer qu’il prendra des décisions de contrôle d’admission basées sur des stratégies en fonction de tous les objets de données de stratégie. Dans ce scénario, le PCM suppose que ce LPM comprend comment générer des objets de données de stratégie pour les messages sortants que le PCM n’est pas en mesure de comprendre.
[out] Reserved
Réservé pour un usage futur.
Valeur retournée
Si le LPM est initialisé avec succès et qu’un type PE valide est retourné dans pSupportedPeType, la valeur de retour est LPM_OK. Le PCM traite n’importe quelle valeur autre que LPM_OK comme une erreur et décharge la DLL (les LPMs sont toujours implémentées en tant que DLL). Si une valeur autre que LPM_OK est retournée ou pSupportedPeType n’est pas valide, le PCM écrit un enregistrement dans le journal des événements et inclut le nom de la DLL et la valeur d’erreur retournée.
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 |