mirror of
https://github.com/modernw/App-Installer-For-Windows-8.x-Reset.git
synced 2026-04-13 20:28:33 +10:00
195 lines
13 KiB
C
195 lines
13 KiB
C
// 下列 ifdef 块是创建使从 DLL 导出更简单的
|
||
// 宏的标准方法。此 DLL 中的所有文件都是用命令行上定义的 PKGMGR_EXPORTS
|
||
// 符号编译的。在使用此 DLL 的
|
||
// 任何其他项目上不应定义此符号。这样，源文件中包含此文件的任何其他项目都会将
|
||
// PKGMGR_API 函数视为是从 DLL 导入的，而此 DLL 则将用此宏定义的
|
||
// 符号视为是被导出的。
|
||
#ifdef PKGMGR_EXPORTS
|
||
#define PKGMGR_API __declspec(dllexport)
|
||
#else
|
||
#define PKGMGR_API __declspec(dllimport)
|
||
#endif
|
||
|
||
// 这里的 API 常用“Appx”在函数名中，此举是为了防止与其他类似的函数名混淆。
|
||
|
||
#ifdef __cplusplus
|
||
extern "C"
|
||
{
|
||
#endif
|
||
#ifdef __cplusplus
|
||
#define _DEFAULT_INIT_VALUE_(_init_value_) = _init_value_
|
||
#ifndef PKGMGR_EXPORTS
|
||
#define _DEFAULT_INIT_VALUE_FORFUNC_(_init_value_) = _init_value_
|
||
#else
|
||
#define _DEFAULT_INIT_VALUE_FORFUNC_(_init_value_)
|
||
#endif
|
||
#else
|
||
#define _DEFAULT_INIT_VALUE_(_init_value_)
|
||
#define _DEFAULT_INIT_VALUE_FORFUNC_(_init_value_)
|
||
#endif
|
||
|
||
// 进度回调。pCustom 可以传入自定义内容
|
||
typedef void (*PKGMRR_PROGRESSCALLBACK) (DWORD dwProgress, void *pCustom);
|
||
|
||
#define PKGMGR_RESULT_OK S_OK
|
||
#define PKGMGR_RESULT_ERROR E_FAIL
|
||
#define PKGMGR_RESULT_CANCEL E_ABORT
|
||
#define PKGMGR_RESULT_STARTED E_PENDING
|
||
|
||
typedef struct _REGISTER_PACKAGE_DEFENDENCIES
|
||
{
|
||
DWORD dwSize _DEFAULT_INIT_VALUE_ (0);
|
||
LPWSTR alpDepUris [1];
|
||
} REGISTER_PACKAGE_DEFENDENCIES, *PREGISTER_PACKAGE_DEFENDENCIES;
|
||
typedef const REGISTER_PACKAGE_DEFENDENCIES CREGISTER_PACKAGE_DEFENDENCIES, *PCREGISTER_PACKAGE_DEFENDENCIES;
|
||
|
||
// 下面值与 Windows::Management::Deployment::DeploymentOptions 一一对应。由于需要写成 API，所以
|
||
// 只能如此。
|
||
// 可查阅文档 https://learn.microsoft.com/zh-cn/uwp/api/windows.management.deployment.deploymentoptions?view=winrt-26100
|
||
|
||
// 设置此选项时，应用将在开发模式下安装。 有关开发模式的信息，请参阅 备注。
|
||
// 使用此选项可启用关键应用开发方案。不能将此选项与捆绑包结合使用。
|
||
// 如果将此选项与捆绑包一起使用，调用将返回ERROR_INSTALL_FAILED。
|
||
#define DEPOLYOPTION_FORCE_APP_SHUTDOWN 0x00000001
|
||
// 如果当前正在使用此包或依赖于此包的任何包，则会强制关闭与该包关联的进程，以便可以继续注册。
|
||
#define DEPOLYOPTION_DEVELOPMENT_MODE 0x00000002
|
||
// 设置此选项时，将指示应用跳过资源适用性检查。 这会有效地暂存或注册用户传递给 命令的所有资源包，
|
||
// 这会强制对捆绑包中包含的所有包具有适用性。 如果用户传入捆绑包，则将注册所有包含的资源包。
|
||
// 仅限 Windows。
|
||
#define DEPOLYOPTION_INSTALL_ALL_RESOURCES 0x00000020
|
||
// 使用默认行为。
|
||
#define DEPOLYOPTION_NONE 0x00000000
|
||
// 安装一个 Appx/AppxBundle/Msix/MsixBundle 包
|
||
// 注意：传入的文件路径为 DOS/NT 风格。如：C:\Windows\...
|
||
// 该函数类似于 PowerShell 的 Add-AppxPackage
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT AddAppxPackageFromPath (LPCWSTR lpPkgPath, PCREGISTER_PACKAGE_DEFENDENCIES alpDepUrlList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 安装一个 Appx/AppxBundle/Msix/MsixBundle 包
|
||
// 注意：传入的文件路径为 URI。
|
||
// 该函数类似于 PowerShell 的 Add-AppxPackage
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT AddAppxPackageFromURI (LPCWSTR lpFileUri, PCREGISTER_PACKAGE_DEFENDENCIES alpDepFullNameList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
|
||
typedef struct _FIND_PACKAGE_ID
|
||
{
|
||
UINT64 qwVersion _DEFAULT_INIT_VALUE_ (0);
|
||
// x86: 0
|
||
// x64: 9
|
||
// Arm: 5
|
||
// Neutral: 11
|
||
// Arm64: 12
|
||
// Unknown: 65535(-1)
|
||
WORD wProcessArchitecture _DEFAULT_INIT_VALUE_ ((WORD)-1);
|
||
WORD wPadding [3];
|
||
LPCWSTR lpName _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpFullName _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpFamilyName _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpPublisher _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpPublisherId _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpResourceId _DEFAULT_INIT_VALUE_ (NULL);
|
||
} FIND_PACKAGE_ID, *PFIND_PACKAGE_ID;
|
||
typedef struct _FIND_PACKAGE_PROPERTIES
|
||
{
|
||
LPCWSTR lpDisplayName _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpDescription _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpPublisher _DEFAULT_INIT_VALUE_ (NULL);
|
||
LPCWSTR lpLogoUri _DEFAULT_INIT_VALUE_ (NULL);
|
||
BOOL bIsFramework _DEFAULT_INIT_VALUE_ (FALSE);
|
||
BOOL bIsResourcePackage _DEFAULT_INIT_VALUE_ (FALSE);
|
||
BOOL bIsBundle _DEFAULT_INIT_VALUE_ (FALSE);
|
||
BOOL bIsDevelopmentMode _DEFAULT_INIT_VALUE_ (FALSE);
|
||
} FIND_PACKAGE_PROPERTIES, *PFIND_PACKAGE_PROPERTIES;
|
||
typedef struct _FIND_PACKAGE_INFO
|
||
{
|
||
FIND_PACKAGE_ID piIdentity;
|
||
FIND_PACKAGE_PROPERTIES piProperties;
|
||
LPCWSTR lpInstallLocation _DEFAULT_INIT_VALUE_ (NULL);
|
||
// 多个用户由 ";" 分隔
|
||
LPCWSTR lpUsers _DEFAULT_INIT_VALUE_ (NULL);
|
||
// 多个用户由 ";" 分隔
|
||
LPCWSTR lpSIDs _DEFAULT_INIT_VALUE_ (NULL);
|
||
DWORD dwDependencesSize _DEFAULT_INIT_VALUE_ (0);
|
||
// 这个项无意义，仅用于内存对齐
|
||
DWORD dwPadding _DEFAULT_INIT_VALUE_ (0);
|
||
// 这个项无意义，除非之后我想通过动态内存方式写依赖项的数组。
|
||
UINT64 ullBuffer _DEFAULT_INIT_VALUE_ (0);
|
||
} FIND_PACKAGE_INFO, *PFIND_PACKAGE_INFO;
|
||
typedef const FIND_PACKAGE_INFO CFIND_PACKAGE_INFO, *LPCFIND_PACKAGE_INFO;
|
||
// 注：回调时的指针不要手动释放
|
||
typedef void (*PKGMGR_FINDENUMCALLBACK) (LPCFIND_PACKAGE_INFO pNowItem, void *pCustom);
|
||
// 通过回调来获取所有包的信息。回调函数允许传自定义内容。返回的值可以判断是否成功。
|
||
// 该函数类似于 PowerShell 的 Get-AppxPackage
|
||
// 注意：回调函数中包的信息无法修改，也不能擅自释放。且随着函数的执行完毕自动释放。这就要求在回调中自行拷贝一份。
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT GetAppxPackages (PKGMGR_FINDENUMCALLBACK pfCallback, void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 移除一个已经安装到电脑上的应用。注意：传入的是包完整名。
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT RemoveAppxPackage (LPCWSTR lpPkgFullName, PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 清理指定用户的指定 包 。 用于清除删除用户用户配置文件后为用户安装的包。
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT CleanupAppxPackage (LPCWSTR lpPkgName, LPCWSTR lpUserSID, PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
|
||
// 注册应用包
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
PKGMGR_API HRESULT RegisterAppxPackageByPath (LPCWSTR lpManifestPath, PCREGISTER_PACKAGE_DEFENDENCIES alpDependencyUriList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 注册应用包
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
PKGMGR_API HRESULT RegisterAppxPackageByUri (LPCWSTR lpManifestUri, PCREGISTER_PACKAGE_DEFENDENCIES alpDependencyUriList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 注册应用包
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
PKGMGR_API HRESULT RegisterAppxPackageByFullName (LPCWSTR lpPackageFullName, PCREGISTER_PACKAGE_DEFENDENCIES alpDepFullNameList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
|
||
// 请查阅 https://learn.microsoft.com/zh-cn/uwp/api/windows.management.deployment.packagestate?view=winrt-26100
|
||
|
||
// 包可用。
|
||
#define PACKAGESTATUS_NORMAL 0
|
||
// 包的许可证无效。
|
||
#define PACKAGESTATUS_LICENSE_INVALID 1
|
||
// 包有效负载由未知源修改。
|
||
#define PACKAGESTATUS_MODIFIED 2
|
||
// 包有效负载被故意篡改。
|
||
#define PACKAGESTATUS_TAMPERED 3
|
||
// 例如，将 包的状态设置为“可用”、“已篡改”等。
|
||
// dwStatus 请使用 PACKAGESTATUS_* 常量
|
||
PKGMGR_API HRESULT SetAppxPackageStatus (LPCWSTR lpPackageFullName, DWORD dwStatus, LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 在不注册包的情况下将 包 暂存到系统。
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
PKGMGR_API HRESULT StageAppxPackageFromURI (LPCWSTR lpFileUri, PCREGISTER_PACKAGE_DEFENDENCIES alpDepUriList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 在不注册包的情况下将 包 暂存到系统。
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
PKGMGR_API HRESULT StageAppxPackageFromPath (LPCWSTR lpFileUri, PCREGISTER_PACKAGE_DEFENDENCIES alpDepUriList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 在不注册包的情况下将 包的 漫游数据暂存到系统。 在暂存包之后、为特定用户注册包之前调用此方法。
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
PKGMGR_API HRESULT StageAppxUserData (LPCWSTR lpPackageFullName, PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 为当前用户汇报已安装的包或其依赖项包。
|
||
// 仅当更新包的版本高于已安装包的版本时，才能更新已安装的包。 如果不存在以前版本的包，则操作将失败。
|
||
// 注意：传入的文件路径为 DOS/NT 风格。如：C:\Windows\...
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT UpdateAppxPackageFromPath (LPCWSTR lpPkgPath, PCREGISTER_PACKAGE_DEFENDENCIES alpDepUrlList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 为当前用户汇报已安装的包或其依赖项包。
|
||
// 仅当更新包的版本高于已安装包的版本时，才能更新已安装的包。 如果不存在以前版本的包，则操作将失败。
|
||
// 注意：传入的文件路径为 URI。
|
||
// dwDeployOption 接受 DEPOLYOPTION_* 常量
|
||
// 输出的错误信息别忘了用 free 释放
|
||
PKGMGR_API HRESULT UpdateAppxPackageFromURI (LPCWSTR lpFileUri, PCREGISTER_PACKAGE_DEFENDENCIES alpDepFullNameList _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), DWORD dwDeployOption _DEFAULT_INIT_VALUE_FORFUNC_ (DEPOLYOPTION_NONE), PKGMRR_PROGRESSCALLBACK pfCallback _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 检索有关为任何用户安装的指定 包 的信息。
|
||
PKGMGR_API HRESULT FindAppxPackage (LPCWSTR lpPackageFullName, PKGMGR_FINDENUMCALLBACK pfCallback, void *pCustom _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pErrorCode _DEFAULT_INIT_VALUE_FORFUNC_ (NULL), LPWSTR *pDetailMsg _DEFAULT_INIT_VALUE_FORFUNC_ (NULL));
|
||
// 获取错误代码。错误代码不一定有，且更多有效信息来自错误详细信息。
|
||
PKGMGR_API LPCWSTR GetPackageManagerLastErrorCode ();
|
||
// 获取错误详细信息。这个是常用的
|
||
PKGMGR_API LPCWSTR GetPackageManagerLastErrorDetailMessage ();
|
||
// 启动 Metro UI 应用
|
||
PKGMGR_API HRESULT ActivateAppxApplication (LPCWSTR lpAppUserId, PDWORD pdwProcessId);
|
||
#ifdef _DEFAULT_INIT_VALUE_
|
||
#undef _DEFAULT_INIT_VALUE_
|
||
#endif
|
||
#ifdef _DEFAULT_INIT_VALUE_FORFUNC_
|
||
#undef _DEFAULT_INIT_VALUE_FORFUNC_
|
||
#endif
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|