LPM_Initialize-Funktion (lpmapi.h)

Artikel
08/24/2023

Die LPM_Initialize-Funktion initialisiert ein lokales Richtlinienmodul (LPM). Dies tritt auf, wenn der Zulassungskontrolldienst richtlinienbasierte Zugriffssteuerungen durchführen muss, z. B. wenn ein SBM zum designated Subnet Bandwidth Manager (DSBM) wird. LPMs sollten sich synchron initialisieren, bevor sie zurückgegeben werden.

Syntax

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

Parameter

[in] LpmHandle

Eindeutiger Handle für das LPM, der vom PCM zugewiesen wird.

[in] pLpmInitInfo

Zeiger auf eine LPM_INIT_INFO-Struktur, die LPM-Initialisierungsinformationen enthält.

[out] pLpmVersionNumber

Angeforderte LPM-Version.

[out] pSupportedPeType

Gültiger Pe-Typ (Policy Element), der vom LPM verwendet wird, um Richtlinienbasierte Entscheidungen zur Zulassungssteuerung zu treffen. Jedes LPM kann nur einen PE-Typ unterstützen, obwohl zukünftige Versionen möglicherweise zulassen, dass ein LPM mehrere PE-Typen unterstützt. Reservierte PE-Typen werden in Lpmapi.h definiert. Weitere Informationen zu Richtlinienelementtypen finden Sie unter Richtlinienelemente.

Es ist möglich, dass eine einzelne DLL mehrere PE-Typen unterstützt, indem der DLL-Name mehrmals in die PCM-Konfigurationsdaten eingegeben wird. Unter diesen Umständen lädt und ruft das PCM dieselbe LPM_Initialize Routine mehrmals auf. Es liegt in der Verantwortung des LPM, verschiedene PE-Typen für diese zusätzlichen Aufrufe zurückzugeben.

LPMs können einen speziellen PE-Typ zurückgeben, LPM_ALL_PE_TYPES, um anzugeben, dass richtlinienbasierte Zugriffssteuerungsentscheidungen basierend auf allen Richtliniendatenobjekten getroffen werden. In diesem Szenario geht der PCM davon aus, dass dieses LPM versteht, wie Richtliniendatenobjekte für ausgehende Nachrichten generiert werden, die vom PCM nicht verstanden werden können.

[out] Reserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn das LPM erfolgreich initialisiert wurde und ein gültiger PE-Typ in pSupportedPeType zurückgegeben wird, wird der Rückgabewert LPM_OK. Der PCM behandelt jeden anderen Wert als LPM_OK als Fehler und entlädt die DLL (LPMs werden immer als DLLs implementiert). Wenn ein anderer Wert als LPM_OK zurückgegeben wird oder pSupportedPeType ungültig ist, schreibt das PCM einen Datensatz in das Ereignisprotokoll und enthält den Namen der DLL und den zurückgegebenen Fehlerwert.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lpmapi.h

Weitere Informationen