userenv.h-Header

Dieser Header wird von mehreren Technologien verwendet. Weitere Informationen finden Sie unter

• Gruppenrichtlinie-API
• Die Windows-Shell

userenv.h enthält die folgenden Programmierschnittstellen:

Functions

CreateAppContainerProfile Erstellt ein Pro-Benutzer-App-Profil für einen AppContainer.
CreateEnvironmentBlock Ruft die Umgebungsvariablen für den angegebenen Benutzer ab. Dieser Block kann dann an die Funktion CreateProcessAsUser übergeben werden.
CreateProfile Erstellt ein neues Benutzerprofil.
DeleteAppContainerProfile Löscht das angegebene Benutzerprofil pro App.
DeleteProfileA Löscht das Benutzerprofil und alle benutzerbezogenen Einstellungen vom angegebenen Computer. Der Aufrufer muss über Administratorrechte verfügen, um das Profil eines Benutzers zu löschen. (ANSI)
DeleteProfileW Löscht das Benutzerprofil und alle benutzerbezogenen Einstellungen vom angegebenen Computer. Der Aufrufer muss über Administratorrechte verfügen, um das Profil eines Benutzers zu löschen. (Unicode)
DeriveAppContainerSidFromAppContainerName Ruft die SID des angegebenen Profils ab.
DeriveRestrictedAppContainerSidFromAppContainerSidAndRestrictedName DeriveRestrictedAppContainerSidFromAppContainerSidAndRestrictedName ist für die zukünftige Verwendung reserviert.
DestroyEnvironmentBlock Gibt Umgebungsvariablen frei, die von der CreateEnvironmentBlock-Funktion erstellt wurden.
EnterCriticalPolicySection Die EnterCriticalPolicySection-Funktion hält die Anwendung der Richtlinie an, damit Anwendungen Richtlinieneinstellungen sicher lesen können.
ExpandEnvironmentStringsForUserA Erweitert die Quellzeichenfolge mithilfe des Umgebungsblocks, der für den angegebenen Benutzer eingerichtet wurde. (ANSI)
ExpandEnvironmentStringsForUserW Erweitert die Quellzeichenfolge mithilfe des Umgebungsblocks, der für den angegebenen Benutzer eingerichtet wurde. (Unicode)
FreeGPOListA Die FreeGPOList-Funktion gibt die angegebene Liste der Gruppenrichtlinienobjekte frei. (ANSI)
FreeGPOListW Die FreeGPOList-Funktion gibt die angegebene Liste der Gruppenrichtlinienobjekte frei. (Unicode)
GetAllUsersProfileDirectoryA Ruft den Pfad zum Stammverzeichnis des Verzeichnisses ab, das Programmdaten enthält, die von allen Benutzern freigegeben werden. (ANSI)
GetAllUsersProfileDirectoryW Ruft den Pfad zum Stammverzeichnis des Verzeichnisses ab, das Programmdaten enthält, die von allen Benutzern freigegeben werden. (Unicode)
GetAppContainerFolderPath Ruft den Pfad des lokalen App-Datenordners für den angegebenen App-Container ab.
GetAppContainerRegistryLocation Ruft den Speicherort des Registrierungsspeichers ab, der einem App-Container zugeordnet ist.
GetAppliedGPOListA Die GetAppliedGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte ab, die für den angegebenen Benutzer oder Computer angewendet wurden. (ANSI)
GetAppliedGPOListW Die GetAppliedGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte ab, die für den angegebenen Benutzer oder Computer angewendet wurden. (Unicode)
GetDefaultUserProfileDirectoryA Ruft den Pfad zum Stamm des Standardbenutzerprofils ab. (ANSI)
GetDefaultUserProfileDirectoryW Ruft den Pfad zum Stamm des Standardbenutzerprofils ab. (Unicode)
GetGPOListA Die GetGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte für den angegebenen Benutzer oder Computer ab. (ANSI)
GetGPOListW Die GetGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte für den angegebenen Benutzer oder Computer ab. (Unicode)
GetProfilesDirectoryA Ruft den Pfad zum Stammverzeichnis ab, in dem Benutzerprofile gespeichert werden. (ANSI)
GetProfilesDirectoryW Ruft den Pfad zum Stammverzeichnis ab, in dem Benutzerprofile gespeichert werden. (Unicode)
GetProfileType Ruft den Typ des Profils ab, das für den aktuellen Benutzer geladen wurde.
GetUserProfileDirectoryA Ruft den Pfad zum Stammverzeichnis des angegebenen Benutzerprofils ab. (ANSI)
GetUserProfileDirectoryW Ruft den Pfad zum Stammverzeichnis des angegebenen Benutzerprofils ab. (Unicode)
LeaveCriticalPolicySection Die LeaveCriticalPolicySection-Funktion setzt die Hintergrundanwendung der Richtlinie fort. Diese Funktion schließt das Handle mit dem Richtlinienabschnitt.
LoadUserProfileA Lädt das profil des angegebenen Benutzers. Das Profil kann ein lokales Benutzerprofil oder ein Roamingbenutzerprofil sein. (ANSI)
LoadUserProfileW Lädt das profil des angegebenen Benutzers. Das Profil kann ein lokales Benutzerprofil oder ein Roamingbenutzerprofil sein. (Unicode)
ProcessGroupPolicyCompleted Die ProcessGroupPolicyCompleted-Funktion benachrichtigt das System, dass die angegebene Erweiterung die Anwendung der Richtlinie abgeschlossen hat.
ProcessGroupPolicyCompletedEx Die ProcessGroupPolicyCompletedEx-Funktion benachrichtigt das System, dass die angegebene Richtlinienerweiterung die Anwendung der Richtlinie abgeschlossen hat. Die Funktion meldet auch die status der Protokollierung von Richtlinienergebnissen (Resultant Set of Policy, RSoP).
RefreshPolicy Die RefreshPolicy-Funktion bewirkt, dass die Richtlinie sofort auf dem Clientcomputer angewendet wird.
RefreshPolicyEx Die RefreshPolicyEx-Funktion bewirkt, dass die Richtlinie sofort auf dem Computer angewendet wird. Mit der erweiterten Funktion können Sie den Typ der anzuwendenden Richtlinienaktualisierung angeben.
RegisterGPNotification Die Funktion RegisterGPNotification ermöglicht es einer Anwendung, Benachrichtigungen zu erhalten, wenn eine Änderung der Richtlinie vorliegt. Wenn eine Richtlinienänderung eintritt, wird das angegebene Ereignisobjekt auf den signalierten Zustand festgelegt.
RsopAccessCheckByType Die RSoPAccessCheckByType-Funktion bestimmt, ob ein Sicherheitsdeskriptor dem Client, der durch einen RSOPTOKEN identifiziert wird, einen angegebenen Satz von Zugriffsrechten gewährt.
RsopFileAccessCheck Die RSoPFileAccessCheck-Funktion bestimmt, ob der Sicherheitsdeskriptor einer Datei dem Client, der durch RSOPTOKEN identifiziert wird, einen bestimmten Satz von Dateizugriffsrechten gewährt.
RsopResetPolicySettingStatus Die RSoPResetPolicySettingStatus-Funktion hebt die Verknüpfung des RSOP_PolicySettingStatus instance mit seiner RSOP_PolicySetting instance auf.
RsopSetPolicySettingStatus Die RSoPSetPolicySettingStatus-Funktion erstellt eine instance von RSOP_PolicySettingStatus und eine instance von RSOP_PolicySettingLink. Die Funktion verknüpft (zugeordnet) RSOP_PolicySettingStatus mit ihrem RSOP_PolicySetting instance.
UnloadUserProfile Entlädt das Profil eines Benutzers, das von der LoadUserProfile-Funktion geladen wurde. Der Aufrufer muss über Administratorrechte auf dem Computer verfügen. Weitere Informationen finden Sie im Abschnitt Hinweise der LoadUserProfile-Funktion.
Aufheben der Registrierung vonGPNotification Die UnregisterGPNotification-Funktion hebt die Registrierung des angegebenen Richtlinienbenachrichtigungshandles vom Empfang von Richtlinienänderungsbenachrichtigungen auf.

Rückruffunktionen

PFNGENERATEGROUPPOLICY Die Rückruffunktion GenerateGroupPolicy ist eine anwendungsdefinierte Rückruffunktion, die jede Richtlinienerweiterung exportieren muss, wenn RSoP-Daten im Planungsmodus generiert werden.
PFNPROCESSGROUPPOLICY Die ProcessGroupPolicy-Funktion ist eine anwendungsdefinierte Rückruffunktion, die beim Anwenden von Richtlinien verwendet wird.
PFNPROCESSGROUPPOLICYEX Die ProcessGroupPolicyEx-Funktion ist eine anwendungsdefinierte Rückruffunktion, die beim Anwenden von Richtlinien verwendet wird.
PFNSTATUSMESSAGECALLBACK Die StatusMessageCallback-Funktion ist eine anwendungsdefinierte Rückruffunktion, mit der beim Anwenden der Richtlinie status Meldungen angezeigt werden.

Strukturen

GROUP_POLICY_OBJECTA Die GROUP_POLICY_OBJECT-Struktur stellt Informationen zu einem Gruppenrichtlinienobjekt in einer Gruppenrichtlinienobjektliste bereit. (ANSI)
GROUP_POLICY_OBJECTW Die GROUP_POLICY_OBJECT-Struktur stellt Informationen zu einem Gruppenrichtlinienobjekt in einer Gruppenrichtlinienobjektliste bereit. (Unicode)
POLICYSETTINGSTATUSINFO Die POLICYSETTINGSTATUSINFO-Struktur stellt Informationen zu einem Richtlinieneinstellungsereignis bereit.
RSOP_TARGET Die RSOP_TARGET-Struktur enthält Computer- und Benutzerinformationen, die für die GenerateGroupPolicy-Funktion erforderlich sind.