DeleteAppContainerProfile function (userenv.h)
Deletes the specified per-user, per-app profile.
Syntax
USERENVAPI HRESULT DeleteAppContainerProfile(
[in] PCWSTR pszAppContainerName
);
Parameters
[in] pszAppContainerName
The name given to the profile in the call to the CreateAppContainerProfile function. This string is at most 64 characters in length, and fits into the pattern described by the regular expression "[-_. A-Za-z0-9]+".
Return value
If this function succeeds, it returns a standard HRESULT code, including the following:
| Return code | Description |
|---|---|
|
If the method is called from within an app container. |
|
The profile was deleted successfully. |
|
If the container name is NULL, or if it exceeds its specified limit for length. |
Remarks
To ensure the best results, close all file handles in the profile storage locations before calling the DeleteAppContainerProfile function. Otherwise, this function may not be able to completely remove the storage locations for the profile.
This function deletes the profile for the current user. To delete the profile for another user, you must impersonate that user.
If the function fails, the status of the profile is undetermined, and you should call DeleteAppContainerProfile again to complete the operation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Target Platform | Windows |
| Header | userenv.h |
| Library | Userenv.lib |
| DLL | Userenv.dll |