deleteAppContainerProfile 函数 (userenv.h)

删除指定的每用户、每应用配置文件。

注意删除不存在的配置文件将返回成功。

语法

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

[in] pszAppContainerName

在对 CreateAppContainerProfile 函数的调用中为配置文件提供的名称。此字符串的长度最多为 64 个字符，适合正则表达式“[-_”描述的模式。 A-Za-z0-9]+”。

如果此函数成功，它将返回标准 HRESULT 代码，其中包括：

返回代码	说明
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	如果从应用容器中调用方法。
S_OK	已成功删除配置文件。
E_INVALIDARG	如果容器名称为 NULL，或超出其指定的长度限制，则为。

为确保获得最佳结果，请在调用 DeleteAppContainerProfile 函数之前关闭配置文件存储位置中的所有文件句柄。否则，此函数可能无法完全删除配置文件的存储位置。

此函数删除当前用户的配置文件。若要删除其他用户的配置文件，必须模拟该用户。

如果函数失败，则配置文件的状态为不确定，应再次调用 DeleteAppContainerProfile 以完成操作。