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 루틴을 여러 번 로드하고 호출합니다. 이러한 추가 호출에 대해 다른 PE 유형을 반환하는 것은 LPM의 책임입니다.

LPM은 LPM_ALL_PE_TYPES 특수 PE 형식을 반환하여 모든 정책 데이터 개체에 따라 정책 기반 허용 제어 결정을 내릴 것임을 나타낼 수 있습니다. 이 시나리오에서 PCM은 이 LPM이 PCM이 이해할 수 없는 나가는 메시지에 대한 정책 데이터 개체를 생성하는 방법을 이해한다고 가정합니다.

[out] Reserved

다음에 사용하도록 예약됩니다.

반환 값

LPM이 성공적으로 초기화되고 pSupportedPeType에서 유효한 PE 형식이 반환되면 반환 값이 LPM_OK. PCM은 LPM_OK 이외의 값을 오류로 처리하고 DLL을 언로드합니다(LPM은 항상 DLL로 구현됨). LPM_OK 이외의 값이 반환되거나 pSupportedPeType 이 잘못된 경우 PCM은 이벤트 로그에 레코드를 쓰고 DLL 이름과 반환된 오류 값을 포함합니다.

요구 사항

참고 항목

LPM_AdmitRsvpMsg

LPM_GetRsvpObjects

PALLOCMEM

PFREEMEM