fungsi LPM_Initialize (lpmapi.h)

Fungsi LPM_Initialize menginisialisasi modul kebijakan lokal (LPM). Ini terjadi ketika Layanan Kontrol Penerimaan perlu melakukan kontrol penerimaan berbasis kebijakan, seperti ketika SBM menjadi Manajer Bandwidth Subnet yang Ditunjuk (DSBM). LPM harus menginisialisasi diri mereka sendiri, secara sinkron, sebelum kembali.

Sintaks

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

Parameter

[in] LpmHandle

Handel unik untuk LPM, ditetapkan oleh PCM.

[in] pLpmInitInfo

Penunjuk ke struktur LPM_INIT_INFO yang berisi informasi inisialisasi LPM.

[out] pLpmVersionNumber

Versi LPM yang diminta.

[out] pSupportedPeType

Jenis elemen kebijakan (PE) yang valid yang digunakan LPM untuk membuat keputusan kontrol penerimaan berbasis kebijakan. Setiap LPM hanya dapat mendukung satu jenis PE, meskipun versi mendatang dapat memungkinkan LPM untuk mendukung beberapa jenis PE. Jenis PE yang dipesan didefinisikan dalam Lpmapi.h. Untuk informasi selengkapnya tentang jenis elemen kebijakan, lihat Elemen Kebijakan.

Dimungkinkan bagi satu DLL untuk mendukung beberapa jenis PE dengan memasukkan nama DLL beberapa kali dalam data konfigurasi PCM. Dalam keadaan seperti itu, PCM akan memuat dan memanggil rutinitas LPM_Initialize yang sama beberapa kali; LPM bertanggung jawab untuk mengembalikan berbagai jenis PE untuk panggilan tambahan ini.

LPM dapat mengembalikan jenis PE khusus, LPM_ALL_PE_TYPES, untuk menunjukkan bahwa itu akan membuat keputusan kontrol penerimaan berbasis kebijakan berdasarkan semua objek data kebijakan. Dalam skenario ini, PCM akan mengasumsikan bahwa LPM ini memahami cara menghasilkan objek data kebijakan untuk pesan keluar yang tidak dapat dipahami PCM.

[out] Reserved

Disiapkan untuk penggunaan masa mendatang.

Mengembalikan nilai

Jika LPM berhasil diinisialisasi, dan jenis PE yang valid dikembalikan dalam pSupportedPeType, nilai yang dikembalikan akan LPM_OK. PCM memperlakukan nilai apa pun selain LPM_OK sebagai kesalahan, dan membongkar DLL (LPM selalu diimplementasikan sebagai DLL). Jika nilai selain LPM_OK dikembalikan atau pSupportedPeType tidak valid, PCM menulis rekaman ke Log Peristiwa dan menyertakan nama DLL dan nilai kesalahan yang dikembalikan.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lpmapi.h

Lihat juga

LPM_AdmitRsvpMsg

LPM_GetRsvpObjects

PALLOCMEM

PFREEMEM