userenv.h 标头

此标头由多种技术使用。 有关详细信息，请参阅：

• 组策略 API
• Windows Shell

userenv.h 包含以下编程接口：

函数

CreateAppContainerProfile 为 AppContainer 创建每用户、每应用配置文件。
CreateEnvironmentBlock 检索指定用户的环境变量。 然后，可以将此块传递给 CreateProcessAsUser 函数。
CreateProfile 创建新的用户配置文件。
DeleteAppContainerProfile 删除指定的每用户、每应用配置文件。
DeleteProfileA 从指定计算机中删除用户配置文件和所有用户相关的设置。 调用方必须具有管理权限才能删除用户的配置文件。 (ANSI)
DeleteProfileW 从指定计算机中删除用户配置文件和所有用户相关的设置。 调用方必须具有管理权限才能删除用户的配置文件。 (Unicode)
DeriveAppContainerSidFromAppContainerName 获取指定配置文件的 SID。
DeriveRestrictedAppContainerSidFromAppContainerSidAndRestrictedName DeriveRestrictedAppContainerSidFromAppContainerSidAndRestrictedName 保留供将来使用。
DestroyEnvironmentBlock 释放 CreateEnvironmentBlock 函数创建的环境变量。
EnterCriticalPolicySection EnterCriticalPolicySection 函数暂停策略的应用，以允许应用程序安全地读取策略设置。
ExpandEnvironmentStringsForUserA 使用为指定用户建立的环境块展开源字符串。 (ANSI)
ExpandEnvironmentStringsForUserW 使用为指定用户建立的环境块展开源字符串。 (Unicode)
FreeGPOListA FreeGPOList 函数释放指定的 GPO 列表。 (ANSI)
FreeGPOListW FreeGPOList 函数释放指定的 GPO 列表。 (Unicode)
GetAllUsersProfileDirectoryA 检索包含所有用户共享的程序数据的目录根目录的路径。 (ANSI)
GetAllUsersProfileDirectoryW 检索包含所有用户共享的程序数据的目录根目录的路径。 (Unicode)
GetAppContainerFolderPath 获取指定应用容器的本地应用数据文件夹的路径。
GetAppContainerRegistryLocation 获取与应用容器关联的注册表存储的位置。
GetAppliedGPOListA GetAppliedGPOList 函数检索应用于指定用户或计算机的 GPO 列表。 (ANSI)
GetAppliedGPOListW GetAppliedGPOList 函数检索应用于指定用户或计算机的 GPO 列表。 (Unicode)
GetDefaultUserProfileDirectoryA 检索默认用户配置文件的根路径。 (ANSI)
GetDefaultUserProfileDirectoryW 检索默认用户配置文件的根路径。 (Unicode)
GetGPOListA GetGPOList 函数检索指定用户或计算机的 GPO 列表。 (ANSI)
GetGPOListW GetGPOList 函数检索指定用户或计算机的 GPO 列表。 (Unicode)
GetProfilesDirectoryA 检索存储用户配置文件的根目录的路径。 (ANSI)
GetProfilesDirectoryW 检索存储用户配置文件的根目录的路径。 (Unicode)
GetProfileType 检索为当前用户加载的配置文件的类型。
GetUserProfileDirectoryA 检索指定用户配置文件的根目录的路径。 (ANSI)
GetUserProfileDirectoryW 检索指定用户配置文件的根目录的路径。 (Unicode)
LeaveCriticalPolicySection LeaveCriticalPolicySection 函数恢复策略的后台应用。 此函数关闭策略节的句柄。
LoadUserProfileA 加载指定用户的配置文件。 配置文件可以是本地用户配置文件或漫游用户配置文件。 (ANSI)
LoadUserProfileW 加载指定用户的配置文件。 配置文件可以是本地用户配置文件或漫游用户配置文件。 (Unicode)
ProcessGroupPolicyCompleted ProcessGroupPolicyCompleted 函数通知系统指定的扩展已完成应用策略。
ProcessGroupPolicyCompletedEx ProcessGroupPolicyCompletedEx 函数通知系统指定的策略扩展已完成应用策略。 函数还会报告策略的结果集的状态 (RSoP) 日志记录。
RefreshPolicy RefreshPolicy 函数可立即在客户端计算机上应用策略。
RefreshPolicyEx RefreshPolicyEx 函数可立即在计算机上应用策略。 扩展函数允许指定要应用的策略刷新的类型。
RegisterGPNotification RegisterGPNotification 函数使应用程序能够在策略发生更改时接收通知。 发生策略更改时，指定的事件对象将设置为信号状态。
RsopAccessCheckByType RSoPAccessCheckByType 函数确定安全描述符是否向 RSOPTOKEN 标识的客户端授予一组指定的访问权限。
RsopFileAccessCheck RSoPFileAccessCheck 函数确定文件的安全描述符是否向由 RSOPTOKEN 标识的客户端授予一组指定的文件访问权限。
RsopResetPolicySettingStatus RSoPResetPolicySettingStatus 函数取消RSOP_PolicySettingStatus实例与其RSOP_PolicySetting实例的链接。
RsopSetPolicySettingStatus RSoPSetPolicySettingStatus 函数创建 RSOP_PolicySettingStatus 实例和 RSOP_PolicySettingLink 实例。 函数将 (关联) RSOP_PolicySettingStatus与其RSOP_PolicySetting实例。
UnloadUserProfile 卸载由 LoadUserProfile 函数加载的用户配置文件。 调用方必须在计算机上具有管理权限。 有关详细信息，请参阅 LoadUserProfile 函数的“备注”部分。
UnregisterGPNotification UnregisterGPNotification 函数从接收策略更改通知时注销指定的策略通知句柄。

回调函数

PFNGENERATEGROUPPOLICY GenerateGroupPolicy 回调函数是应用程序定义的回调函数，每个策略扩展在计划模式下生成 RSoP 数据时都必须导出该回调函数。
PFNPROCESSGROUPPOLICY ProcessGroupPolicy 函数是应用策略时使用的应用程序定义的回调函数。
PFNPROCESSGROUPPOLICYEX ProcessGroupPolicyEx 函数是应用策略时使用的应用程序定义的回调函数。
PFNSTATUSMESSAGECALLBACK StatusMessageCallback 函数是应用程序定义的回调函数，用于在应用策略时显示状态消息。

结构

GROUP_POLICY_OBJECTA GROUP_POLICY_OBJECT结构提供有关 GPO 列表中的 GPO 的信息。 (ANSI)
GROUP_POLICY_OBJECTW GROUP_POLICY_OBJECT结构提供有关 GPO 列表中的 GPO 的信息。 (Unicode)
POLICYSETTINGSTATUSINFO POLICYSETTINGSTATUSINFO 结构提供有关策略设置事件的信息。
RSOP_TARGET RSOP_TARGET结构包含 GenerateGroupPolicy 函数所需的计算机和用户信息。