PFNGENERATEGROUPPOLICY-Rückruffunktion (userenv.h)
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.
GPO_INFO_FLAG_SLOWLINK
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 |