fonction LPM_Initialize (lpmapi.h)

Article
08/24/2023

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é (DSBM). Les LPM doivent s’initialiser de manière 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, attribué par le PCM.

[in] pLpmInitInfo

Pointeur vers une structure de 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) que le LPM utilise 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 ultérieures 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 seule DLL de prendre en charge plusieurs types PE en entrant plusieurs fois le nom de dll dans les données de configuration PCM. Dans de telles circonstances, le PCM chargera et appellera le même LPM_Initialize routine plusieurs fois; il est de la responsabilité du LPM de retourner différents types d’PE pour ces appels supplémentaires.

Les LPM 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 part du principe 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é correctement et qu’un type PE valide est retourné dans pSupportedPeType, la valeur de retour est LPM_OK. Le PCM traite toute valeur autre que LPM_OK comme une erreur et décharge la DLL (les LPM sont toujours implémentés en tant que DLL). Si une valeur autre que LPM_OK est retournée ou si 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.

Spécifications


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