mirror of
https://github.com/modernw/App-Installer-For-Windows-8.x-Reset.git
synced 2026-04-11 17:57:19 +10:00
215 lines
12 KiB
C++
215 lines
12 KiB
C++
// 下列 ifdef 块是创建使从 DLL 导出更简单的
|
||
// 宏的标准方法。此 DLL 中的所有文件都是用命令行上定义的 PKGMGR_EXPORTS
|
||
// 符号编译的。在使用此 DLL 的
|
||
// 任何其他项目上不应定义此符号。这样，源文件中包含此文件的任何其他项目都会将
|
||
// PKGMGR_API 函数视为是从 DLL 导入的，而此 DLL 则将用此宏定义的
|
||
// 符号视为是被导出的。
|
||
#ifdef NOTICE_EXPORTS
|
||
#define NOTICE_API __declspec(dllexport)
|
||
#else
|
||
#define NOTICE_API __declspec(dllimport)
|
||
#endif
|
||
|
||
// 这里的 API 常用“Appx”在函数名中，此举是为了防止与其他类似的函数名混淆。
|
||
|
||
#ifdef __cplusplus
|
||
extern "C"
|
||
{
|
||
#endif
|
||
#ifdef __cplusplus
|
||
#define _DEFAULT_INIT_VALUE_(_init_value_) = _init_value_
|
||
#ifndef NOTICE_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
|
||
typedef void (*NOTICE_ACTIVECALLBACK) (void *pCustom);
|
||
// 参考：https://learn.microsoft.com/zh-cn/previous-versions/windows/apps/hh761494(v=win.10)
|
||
// 通过 Toast 通知名来获取 XML 模板。
|
||
// 不符合会返回一个默认模板（只会有一个 text 节点。根据需要的话可以自己添加）
|
||
// 注意：返回的指针要自己 NoticeApiFreeString 释放
|
||
NOTICE_API LPWSTR GetToastNoticeXml (LPCWSTR lpTemplateName);
|
||
// 获取一个简单的 Toast 通知 XML 文档。第一个参数是必须的。第二个参数为图片 URI（file:///）。
|
||
// 第二个参数如果为 NULL 或去掉首尾空的长度为 0 的文本则不会使用带图片的模板。
|
||
// 注意：返回的指针要自己通过 NoticeApiFreeString 释放
|
||
NOTICE_API LPWSTR GenerateSimpleToastNoticeXml (LPCWSTR lpText, LPCWSTR lpImagePath);
|
||
// 获取一个简单的 Toast 通知 XML 文档。第一个参数是必须的。第三个参数为图片 URI（file:///）。
|
||
// 第三个参数如果为 NULL 或去掉首尾空的长度为 0 的文本则不会使用带图片的模板。
|
||
// 第二个参数可以为 NULL 或空文本。当为空时不会使用相关模板
|
||
// 注意：返回的指针要自己通过 NoticeApiFreeString 释放
|
||
NOTICE_API LPWSTR GenerateSimpleToastNoticeXml2 (LPCWSTR lpTitle, LPCWSTR lpText, LPCWSTR lpImagePath);
|
||
// 创建并显示一个 Toast 通知
|
||
// 参数1 为非必须项，这意味着可以传入 NULL 或空文本。但是建议必须填。桌面应用
|
||
// 必须在开始菜单快捷方式储存处创建一个含有 AppUserModelID 的快捷方式才能使用 Toast 通知。而这个限制
|
||
// 在 Windows 10 已经去除。
|
||
// pfCallback 为点击 Toast 通知本体后触发的回调函数。注意：仅运行期才能用，且不一定会调用成功
|
||
// pCustom 可以传入自定义内容并在回调中使用
|
||
// lpExceptMsg 返回异常信息。获取到的指针必须由 NoticeApiFreeString 释放。
|
||
NOTICE_API HRESULT CreateToastNoticeFromXmlDocument (LPCWSTR lpIdName, LPCWSTR lpXmlString, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
// 创建一个简单的 Toast 通知。仅支持一段文本和一张图片（图片若不需要则设置为 NULL 或空文本）
|
||
// 一些参数作用与 CreateToastNoticeFromXmlDocument 中的同名参数作用一致。
|
||
NOTICE_API HRESULT CreateToastNotice (LPCWSTR lpIdName, LPCWSTR lpText, LPCWSTR lpImgPath, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
// 创建一个简单的 Toast 通知。支持两段文本和一张图片（图片若不需要则设置为 NULL 或空文本）
|
||
// lpText 可以设置为 NULL 或空文本。此时函数的作用与 CreateToastNotice 一致。
|
||
// 一些参数作用与 CreateToastNoticeFromXmlDocument 中的同名参数作用一致。
|
||
NOTICE_API HRESULT CreateToastNotice2 (LPCWSTR lpIdName, LPCWSTR lpTitle, LPCWSTR lpText, LPCWSTR lpImgPath, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
// 创建一个简单的 Toast 通知。支持两段文本和一张图片（图片是 IStream 流，如果不想设置则置 NULL）
|
||
// lpText 可以设置为 NULL 或空文本。此时函数的作用与 CreateToastNoticeWithIStream 一致。
|
||
// 一些参数作用与 CreateToastNoticeFromXmlDocument 中的同名参数作用一致。
|
||
NOTICE_API HRESULT CreateToastNoticeWithIStream2 (LPCWSTR lpIdName, LPCWSTR lpTitle, LPCWSTR lpText, HANDLE pIImgStream, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
// 创建一个简单的 Toast 通知。支持两段文本和一张图片（图片是 IStream 流，如果不想设置则置 NULL）
|
||
// 一些参数作用与 CreateToastNoticeFromXmlDocument 中的同名参数作用一致。
|
||
NOTICE_API HRESULT CreateToastNoticeWithIStream (LPCWSTR lpIdName, LPCWSTR lpText, HANDLE pIImgStream, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
// 获取上一次操作的 HReuslt（注意：返回的 HResult 不一定代表错误，因为这是记录每一个步骤的 HResult）
|
||
NOTICE_API HRESULT NoticeGetLastHResult ();
|
||
// 获取上一次异常操作的错误信息。（注意：仅在发生异常时才会记录）
|
||
NOTICE_API LPCWSTR NoticeGetLastDetailMessage ();
|
||
// 创建快捷方式
|
||
// （不用安装程序原生的创建，因为需要 AppUserID 才能使用 Toast 通知，当然这个限制只有 Windows 8.x 有，Windows 10 没有这个限制了）
|
||
NOTICE_API HRESULT CreateShortcutWithAppIdW (LPCWSTR pszShortcutPath, LPCWSTR pszTargetPath, LPCWSTR pszAppId, LPWSTR *lpException);
|
||
// 由 notice.dll 获取到的动态字符串必须由此释放。
|
||
NOTICE_API void NoticeApiFreeString (LPWSTR lpstr);
|
||
// 创建一个简单的 Toast 通知。支持两段文本和一张图片（图片是 data uri 或者只是 Base64 编码后的字符串，如果不想设置则置 NULL）
|
||
// 一些参数作用与 CreateToastNoticeFromXmlDocument 中的同名参数作用一致。
|
||
NOTICE_API HRESULT CreateToastNoticeWithImgBase64 (LPCWSTR lpIdName, LPCWSTR lpText, LPCWSTR lpImgBase64, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
// 创建一个简单的 Toast 通知。支持两段文本和一张图片（图片是 data uri 或者只是 Base64 编码后的字符串，如果不想设置则置 NULL）
|
||
// lpText 可以设置为 NULL 或空文本。此时函数的作用与 CreateToastNoticeWithIStream 一致。
|
||
// 一些参数作用与 CreateToastNoticeFromXmlDocument 中的同名参数作用一致。
|
||
NOTICE_API HRESULT CreateToastNotice2WithImgBase64 (LPCWSTR lpIdName, LPCWSTR lpTitle, LPCWSTR lpText, LPCWSTR lpImgBase64, NOTICE_ACTIVECALLBACK pfCallback, void *pCustom, LPWSTR *lpExceptMsg);
|
||
|
||
#ifdef _DEFAULT_INIT_VALUE_
|
||
#undef _DEFAULT_INIT_VALUE_
|
||
#endif
|
||
#ifdef _DEFAULT_INIT_VALUE_FORFUNC_
|
||
#undef _DEFAULT_INIT_VALUE_FORFUNC_
|
||
#endif
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#ifdef __cplusplus
|
||
#include <string>
|
||
#include <functional>
|
||
namespace notice
|
||
{
|
||
// using LPWSTR = wchar_t *;
|
||
struct destruct
|
||
{
|
||
using funcend = std::function <void ()>;
|
||
funcend endtask = nullptr;
|
||
destruct (funcend endtask): endtask (endtask) {}
|
||
~destruct () { if (endtask) endtask (); }
|
||
destruct (destruct &) = delete;
|
||
};
|
||
struct autostr
|
||
{
|
||
LPWSTR lpstr = nullptr;
|
||
destruct reltask = [this] () {
|
||
if (lpstr) NoticeApiFreeString (lpstr);
|
||
lpstr = nullptr;
|
||
};
|
||
autostr (LPWSTR str = nullptr): lpstr (str) {}
|
||
operator LPWSTR () const { return lpstr; }
|
||
operator std::wstring () const { return lpstr ? lpstr : L""; }
|
||
std::wstring get_string () { return lpstr ? lpstr : L""; }
|
||
};
|
||
using qwstring = std::wstring &;
|
||
using qcwstring = const std::wstring &;
|
||
struct hresult
|
||
{
|
||
HRESULT hr = S_OK;
|
||
std::wstring message = L"";
|
||
operator HRESULT () const { return hr; }
|
||
operator std::wstring () const { return message; }
|
||
hresult (HRESULT hr = S_OK, qcwstring msg = L""): hr (hr), message (msg) {}
|
||
};
|
||
}
|
||
std::wstring GetToastNoticeXml (notice::qcwstring template_name) { return notice::autostr (GetToastNoticeXml (template_name.c_str ())).get_string (); }
|
||
std::wstring GenerateSimpleToastNoticeXml (notice::qcwstring text, notice::qcwstring imgurl = L"") { return notice::autostr (GenerateSimpleToastNoticeXml (text.c_str (), imgurl.c_str ())).get_string (); }
|
||
std::wstring GenerateSimpleToastNoticeXml (notice::qcwstring title, notice::qcwstring text, notice::qcwstring imgurl) { return notice::autostr (GenerateSimpleToastNoticeXml2 (title.c_str (), text.c_str (), imgurl.c_str ())).get_string (); }
|
||
std::wstring GenerateSimpleToastNoticeXml2 (notice::qcwstring title, notice::qcwstring text = L"", notice::qcwstring imgurl = L"") { return GenerateSimpleToastNoticeXml2 (title, text, imgurl); }
|
||
void ToastNoticeEventCallback (void *pCustom)
|
||
{
|
||
if (pCustom)
|
||
{
|
||
using cbfunc = std::function <void ()>;
|
||
auto func = reinterpret_cast <cbfunc *> (pCustom);
|
||
if (func) (*func)();
|
||
}
|
||
}
|
||
notice::hresult CreateToastNoticeFromXmlDocument (notice::qcwstring idname, notice::qcwstring xmlstring, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNoticeFromXmlDocument (idname.c_str (), xmlstring.c_str (), &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
notice::hresult CreateToastNotice (notice::qcwstring idname, notice::qcwstring text, notice::qcwstring imgpath, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNotice (idname.c_str (), text.c_str (), imgpath.c_str (), &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
notice::hresult CreateToastNotice (notice::qcwstring idname, notice::qcwstring title, notice::qcwstring text, notice::qcwstring imgpath, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNotice2 (idname.c_str (), title.c_str (), text.c_str (), imgpath.c_str (), &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
notice::hresult CreateToastNotice2 (notice::qcwstring idname, notice::qcwstring title, notice::qcwstring text = L"", notice::qcwstring imgpath = L"", std::function <void ()> callback = nullptr) { return CreateToastNotice (idname, title, text, imgpath, callback); }
|
||
notice::hresult CreateToastNoticeWithIStream (notice::qcwstring idname, notice::qcwstring text, IStream *imgstream, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNoticeWithIStream (idname.c_str (), text.c_str (), imgstream, &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
notice::hresult CreateToastNoticeWithIStream2 (notice::qcwstring idname, notice::qcwstring title, notice::qcwstring text = L"", IStream *imgstream = nullptr, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNoticeWithIStream2 (idname.c_str (), title.c_str (), text.c_str (), imgstream, &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
notice::hresult CreateToastNoticeWithIStream (notice::qcwstring idname, notice::qcwstring title, notice::qcwstring text, IStream *imgstream, std::function <void ()> callback = nullptr) { return CreateToastNoticeWithIStream2 (idname, title, text, imgstream, callback); }
|
||
notice::hresult CreateToastNotice (notice::qcwstring idname, notice::qcwstring xmlstring, std::function <void ()> callback) { return CreateToastNoticeFromXmlDocument (idname, xmlstring, callback); }
|
||
notice::hresult CreateToastNotice (notice::qcwstring idname, notice::qcwstring text, IStream *imgstream, std::function <void ()> callback = nullptr) { return CreateToastNoticeWithIStream (idname, text, imgstream, callback); }
|
||
notice::hresult CreateToastNotice (notice::qcwstring idname, notice::qcwstring title, notice::qcwstring text, IStream *imgstream, std::function <void ()> callback = nullptr) { return CreateToastNoticeWithIStream2 (idname, title, text, imgstream, callback); }
|
||
notice::hresult CreateShortcutWithAppIdW (notice::qcwstring shortcut_path, notice::qcwstring targetpath, notice::qcwstring appid)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateShortcutWithAppIdW (shortcut_path.c_str (), targetpath.c_str (), appid.c_str (), &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
HRESULT CreateToastNoticeWithImgBase64 (notice::qcwstring idname, notice::qcwstring text, notice::qcwstring imgbase64, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNoticeWithImgBase64 (idname.c_str (), text.c_str (), imgbase64.c_str (), &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
HRESULT CreateToastNotice2WithImgBase64 (notice::qcwstring idname, notice::qcwstring title, notice::qcwstring text, notice::qcwstring imgbase64, std::function <void ()> callback = nullptr)
|
||
{
|
||
notice::autostr exp;
|
||
notice::hresult hr;
|
||
hr.hr = CreateToastNotice2WithImgBase64 (idname.c_str (), title.c_str (), text.c_str (), imgbase64.c_str (), &ToastNoticeEventCallback, &callback, &exp.lpstr);
|
||
hr.message = exp.get_string ();
|
||
return hr;
|
||
}
|
||
// WinRT API 测试用
|
||
|
||
#endif |