PFNGENERATEGROUPPOLICY-Rückruffunktion (userenv.h)

  • Artikel

Die Rückruffunktion GenerateGroupPolicy ist eine anwendungsdefinierte Rückruffunktion, die jede Richtlinienerweiterung exportieren muss, wenn RSoP-Daten im Planungsmodus generiert werden. Der Gruppenrichtlinie Data Access Service (GPDAS) ruft die Funktion auf, nachdem der Dienst das Laden clientseitiger Erweiterungen simuliert hat, damit Erweiterungen Richtliniendaten generieren können.

Der PFNGENERATEGROUPPOLICY-Typ definiert einen Zeiger auf diese Rückruffunktion. GenerateGroupPolicy ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFNGENERATEGROUPPOLICY Pfngenerategrouppolicy;

DWORD Pfngenerategrouppolicy(
  [in] DWORD dwFlags,
  [in] BOOL *pbAbort,
  [in] WCHAR *pwszSite,
  [in] PRSOP_TARGET pComputerTarget,
  [in] PRSOP_TARGET pUserTarget
)
{...}

Parameter

[in] dwFlags

Ein Parameter, der mindestens eins der folgenden Flags darstellt.

Die Richtlinie wird auf einen langsamen Link angewendet.

GPO_INFO_FLAG_VERBOSE

Schreiben Sie ausführliche Ausgabe in das Ereignisprotokoll.

[in] pbAbort

Ein Wert, der angibt, ob die Verarbeitung von Gruppenrichtlinienobjekten fortgesetzt werden soll. Wenn dieser Parameter TRUE ist, wird die Gruppenrichtlinienobjektverarbeitung beendet, und die Erweiterung muss die Zuordnung der Ressourcen aufheben und umgehend zurückgeben. Wenn dieser Parameter FALSE ist, wird die Gruppenrichtlinienobjektverarbeitung fortgesetzt.

[in] pwszSite

Ein Zeiger auf den Standortnamen des Zielcomputers. Dieser Parameter kann NULL sein.

[in] pComputerTarget

Ein Zeiger auf eine RSOP_TARGET Struktur, die Informationen zu einem Computer enthält. Dieser Parameter kann NULL sein, aber wenn er NULL ist, ist der pUserTarget-Parameter erforderlich.

[in] pUserTarget

Ein Zeiger auf eine RSOP_TARGET Struktur, die Informationen zu einem Benutzer enthält. Dieser Parameter kann NULL sein, aber wenn er NULL ist, ist der pComputerTarget-Parameter erforderlich.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS. Andernfalls gibt die Funktion einen der Systemfehlercodes zurück. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes oder in der Headerdatei WinError.h.

Hinweise

Die Richtlinienerweiterung muss diese Rückruffunktion beim Registrierungsschlüssel registrieren:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\GPExtensions\ClientExtensionGuid

GenerateGroupPolicy-REG_SZ

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile userenv.h

Weitere Informationen

Gruppenrichtlinie-Funktionen

Übersicht über Gruppenrichtlinien

RSOP_TARGET