funzione LPM_Initialize (lpmapi.h)

La funzione LPM_Initialize inizializza un modulo criteri locale (LPM). Ciò si verifica quando il servizio di controllo di ammissione deve eseguire un controllo basato su criteri di ammissione, ad esempio quando un SBM diventa il gestore della larghezza di banda della subnet designato. I moduli LPM devono inizializzarsi, in modo sincrono, prima di tornare.

Sintassi

ULONG LPM_Initialize(
  [in]  LPM_HANDLE    LpmHandle,
  [in]  LPM_INIT_INFO *pLpmInitInfo,
  [out] DWORD         *pLpmVersionNumber,
  [out] PETYPE        *pSupportedPeType,
  [out] VOID          *Reserved
);

Parametri

[in] LpmHandle

Handle univoco per LPM, assegnato dal PCM.

[in] pLpmInitInfo

Puntatore a una struttura LPM_INIT_INFO contenente informazioni sull'inizializzazione LPM.

[out] pLpmVersionNumber

Versione di LPM richiesta.

[out] pSupportedPeType

Tipo di elemento criteri valido (PE) usato da LPM per prendere decisioni di controllo di ammissione basate su criteri. Ogni LPM può supportare un solo tipo PE, anche se le versioni future possono consentire a un LPM di supportare più tipi PE. I tipi PE riservati sono definiti in Lpmapi.h. Per altre informazioni sui tipi di elementi dei criteri, vedere Elementi dei criteri.

È possibile che una singola DLL supporti più tipi PE avendo il nome della DLL immesso più volte nei dati di configurazione PCM. In tali circostanze, il PCM caricherà e chiamerà la stessa routine LPM_Initialize più volte; è responsabilità di LPM restituire tipi PE diversi per queste chiamate aggiuntive.

LPMs può restituire un tipo PE speciale, LPM_ALL_PE_TYPES, per indicare che prenderà decisioni di controllo di ammissione basate su criteri in base a tutti gli oggetti dati dei criteri. In questo scenario, PCM presuppone che questo LPM comprenda come generare oggetti dati dei criteri per i messaggi in uscita che PCM non è in grado di comprendere.

[out] Reserved

Riservato per utilizzi futuri.

Valore restituito

Se LPM viene inizializzato correttamente e viene restituito un tipo PE valido in pSupportedPeType, il valore restituito verrà LPM_OK. PCM considera qualsiasi valore diverso da LPM_OK come errore e scarica la DLL (IPM vengono sempre implementati come DLL). Se viene restituito un valore diverso da LPM_OK o pSupportedPeType non è valido, il PCM scrive un record nel registro eventi e include il nome della DLL e il valore di errore restituito.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lpmapi.h

Vedi anche

LPM_AdmitRsvpMsg

LPM_GetRsvpObjects

PALLOCMEM

PFREEMEM