Функция 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

Уникальный дескриптор LPM, назначенный PCM.

[in] pLpmInitInfo

Указатель на структуру LPM_INIT_INFO, содержащую сведения об инициализации LPM.

[out] pLpmVersionNumber

Запрашиваемая версия LPM.

[out] pSupportedPeType

Допустимый тип элемента политики (PE), который LPM использует для принятия решений по контролю допуска на основе политик. Каждый LPM может поддерживать только один тип PE, хотя в будущих версиях LPM может поддерживаться несколько типов PE. Зарезервированные типы PE определяются в Lpmapi.h. Дополнительные сведения о типах элементов политики см. в разделе Элементы политики.

Одна библиотека DLL может поддерживать несколько типов PE, если имя библиотеки DLL вводится несколько раз в данных конфигурации PCM. В таких случаях 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 (LPM всегда реализуются как библиотеки DLL). Если возвращается значение, отличное от LPM_OK, или pSupportedPeType является недопустимым, PCM записывает запись в журнал событий и включает имя библиотеки DLL и возвращаемое значение ошибки.

Требования

Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	lpmapi.h

См. также раздел

LPM_AdmitRsvpMsg

LPM_GetRsvpObjects

PALLOCMEM

PFREEMEM