DeleteAppContainerProfile 函式 (userenv.h)
刪除指定的個別使用者、個別應用程式配置檔。
注意 刪除不存在的配置檔會傳回成功。
語法
USERENVAPI HRESULT DeleteAppContainerProfile(
[in] PCWSTR pszAppContainerName
);
參數
[in] pszAppContainerName
呼叫 CreateAppContainerProfile 函式時提供給配置文件的名稱。 此字串長度最多為64個字元,並符合正則表示式“[-_” 所描述的模式。 A-Za-z0-9]+”。
傳回值
如果此函式成功,它會傳回標準 HRESULT 程式代碼,包括下列各項:
傳回碼 | Description |
---|---|
|
如果從應用程式容器內呼叫 方法。 |
|
已成功刪除配置檔。 |
|
如果容器名稱為 NULL,或超過其指定的長度限制,則為 。 |
備註
若要確保最佳結果,請先關閉配置檔儲存位置中的所有檔案句柄,再呼叫 DeleteAppContainerProfile 函式。 否則,此函式可能無法完全移除配置檔的儲存位置。
此函式會刪除目前使用者的配置檔。 若要刪除其他使用者的配置檔,您必須模擬該使用者。
如果函式失敗,配置檔的狀態是不確定的,您應該再次呼叫 DeleteAppContainerProfile 來完成作業。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | userenv.h |
程式庫 | Userenv.lib |
Dll | Userenv.dll |