LPM_Initialize函式 (lpmapi.h)

LPM_Initialize函式會在 LPM) (初始化本機原則模組。 當許可控制服務需要執行原則型許可控制時，例如當 SBM 變成指定的子網路頻寬管理員 (DSBM) 時，就會發生這種情況。 在傳回之前，LPM 應該先同步初始化自己。

語法

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

參數

[in] LpmHandle

由 PCM 指派之 LPM 的唯一控制碼。

[in] pLpmInitInfo

包含 LPM 初始化資訊的LPM_INIT_INFO結構的指標。

[out] pLpmVersionNumber

要求 LPM 的版本。

[out] pSupportedPeType

LPM 用來做出原則型許可控制決策的有效原則元素 (PE) 類型。 每個 LPM 只能支援一個 PE 類型，不過未來的版本可能會允許 LPM 支援多個 PE 類型。 保留的 PE 類型定義于 Lpmapi.h 中。 如需原則專案類型的詳細資訊，請參閱 原則元素。

單一 DLL 可以藉由在 PCM 組態資料中輸入 DLL 名稱多次來支援多個 PE 類型。 在這種情況下，PCM 會多次載入並呼叫相同的LPM_Initialize常式;LPM 負責傳回這些額外呼叫的不同 PE 類型。

LPM 可以傳回特殊的 PE 類型LPM_ALL_PE_TYPES，以指出它會根據所有原則資料物件做出原則型許可控制決策。 在此案例中，PCM 會假設此 LPM 瞭解如何為 PCM 無法瞭解的傳出訊息產生原則資料物件。

[out] Reserved

保留供未來使用。

傳回值

如果 LPM 已成功初始化，且 pSupportedPeType中傳回有效的 PE 類型，則會LPM_OK傳回值。 PCM 會將LPM_OK以外的任何值視為錯誤，而且卸載 DLL (LP 一律會實作為 DLL) 。 如果傳回LPM_OK以外的值或 pSupportedPeType 無效，PCM 會將記錄寫入事件記錄檔，並包含 DLL 的名稱和傳回的錯誤值。

需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	lpmapi.h

另請參閱

LPM_AdmitRsvpMsg

LPM_GetRsvpObjects

PALLOCMEM

PFREEMEM