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 の種類は 1 つだけですが、将来のバージョンでは、LPM で複数の PE 型をサポートできる場合があります。 予約済み PE 型は Lpmapi.h で定義されています。 ポリシー要素の種類の詳細については、「 ポリシー要素」を参照してください。
PCM 構成データに DLL 名を複数回入力することで、1 つの DLL で複数の PE 型をサポートできます。 このような状況では、PCM は同じLPM_Initialize ルーチンを複数回読み込んで呼び出します。これらの追加の呼び出しに対して異なる PE 型を返すのは LPM の責任です。
LPM は、特殊な PE 型 (LPM_ALL_PE_TYPES) を返して、すべてのポリシー データ オブジェクトに基づいてポリシー ベースのアドミッション制御を決定することを示すことができます。 このシナリオでは、PCM は、PCM が理解できない送信メッセージのポリシー データ オブジェクトを生成する方法を、この LPM が理解していることを前提としています。
[out] Reserved
将来利用するために予約されています。
戻り値
LPM が正常に初期化され、有効な PE 型が pSupportedPeType で返された場合、戻り値はLPM_OK。 PCM は、LPM_OK以外の値をエラーとして扱い、DLL をアンロードします (LPM は常に DLL として実装されます)。 LPM_OK以外の値が返された場合、または pSupportedPeType が無効な場合、PCM はイベント ログにレコードを書き込み、DLL の名前と返されたエラー値を含めます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lpmapi.h |