Win32 API on kenji.blog

如何從 C++ 呼叫 Microsoft.Windows.AI

Sat, 19 Jul 2025 10:03:51 +0900

🎯 如何從 C++ 呼叫 `Microsoft.Windows.AI`【附範例程式碼】

自 Windows 10 起，Windows 預設內建了 能夠執行 ONNX 格式 AI 模型的執行階段 。這就是 Windows ML (Windows.AI.MachineLearning) 。

這篇文章將具體解說如何從 C++（基於 Win32 應用程式） 呼叫 Microsoft.Windows.AI.MachineLearning ，並 附上範例程式碼具體解說 。

✅ 準備篇

◾ 系統需求

Windows 10 (1809+) 或 Windows 11
Visual Studio 2019 或以上版本（Community 版即可）
支援 C++/WinRT (Microsoft.Windows.CppWinRT)
Windows SDK 10.0.17763.0 或以上版本

✅ 專案結構

在 Visual Studio 中建立具有以下結構的專案。

類型：C++ Windows 桌面應用程式（空白專案）
子系統：Windows (WinMain)
透過 NuGet 新增以下套件
1

Microsoft.Windows.CppWinRT

✅ 範例程式碼

以下是使用 WinMain 並結合 Win32 API 與 Windows.AI.MachineLearning 的最小配置範例。

※ 使用的 ONNX 模型假設為 model.onnx ，請將其放置在與執行檔相同的資料夾中。

`main.cpp`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38


#include <windows.h>
#include <winrt/Windows.AI.MachineLearning.h>
#include <winrt/Windows.Storage.h>

#pragma comment(lib, "windowsapp") // 用於 WinRT 連結

using namespace winrt;
using namespace Windows::AI::MachineLearning;
using namespace Windows::Storage;

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE, LPSTR, int nCmdShow)
{
 // WinRT 初始化（MTA 或 STA 皆可）
 winrt::init_apartment();

 try {
 // 讀取模型檔案
 auto modelFile = StorageFile::GetFileFromPathAsync(L"model.onnx").get();
 LearningModel model = LearningModel::LoadFromStorageFileAsync(modelFile).get();

 // 建立工作階段
 LearningModelSession session(model);
 LearningModelBinding binding(session);

 // 模型的輸入與輸出（此處暫時為空輸入）
 // 實際上需要繫結 TensorFloat 等

 // 執行推論
 auto result = session.EvaluateAsync(binding, L"").get();

 MessageBox(nullptr, L"推論已完成", L"Windows ML (C++)", MB_OK);
 }
 catch (winrt::hresult_error const& ex) {
 MessageBox(nullptr, ex.message().c_str(), L"錯誤", MB_ICONERROR);
 }

 return 0;
}

✅ 補充：如何指定輸入與輸出 Tensor

根據模型的不同，在推論前可能需要 建立並繫結 Tensor 。

範例：

1
2
3
4
5
6
7
8


// 將一維 float 陣列轉換為 Tensor
std::vector<float> inputData = {0.5f, 0.3f, 0.2f};
std::vector<int64_t> shape = {1, 3}; // 形狀：[1, 3]

auto tensor = TensorFloat::CreateFromArray(shape, inputData);

// 輸入繫結（需符合模型的輸入名稱）
binding.Bind(L"input_0", tensor);

輸出也同樣可以透過 result.Outputs().Lookup(L"output_0") 取得。

✅ 偵錯時的注意事項

若模型檔案不存在於執行資料夾中，將會拋出 FileNotFoundException 。
若輸入或輸出名稱不符，將會產生 invalid_argument 錯誤。
模型正確的 IO 規格可以使用 Netron 等工具確認。

✅ 總結

項目	內容
使用 API	Windows.AI.MachineLearning (WinRT)
語言	C++（基於 Win32）
建議方法	透過 C++/WinRT 標頭檔
優點	原生執行 ONNX 模型，也支援 GPU
注意	注意模型的輸入名稱與 Tensor 形狀

✅ 替代方案：給不想使用 WinRT 的人

若使用微軟的 ONNX Runtime ，就能 完全不需要 WinRT 即可從 C++ 處理 ONNX 模型 。
支援跨平台，在 Windows 或 Linux 上也可以使用共通的程式碼。

📌 結語

Windows ML (Microsoft.Windows.AI) 是一個非常強大的人工智慧推論引擎，即使從 C++ 也能輕鬆使用。如果需要在 Windows 上進行原生推論，請務必嘗試看看。

如果您需要建立 ONNX 模型或 Tensor 繫結的具體範例，我們將在後續文章中進行解說！

如何使用 Slack App + OAuth2 發送訊息到 Slack

Wed, 16 Jul 2025 23:36:27 +0900

✅ 使用存取權杖的發文方法（Slack Web API）

Slack 的「OAuth Token（例如 xoxb-… 等）」是用來透過 Slack 的 Web API 發文的密鑰。在這種情況下，與 Webhook 不同，你需要向 Slack API 端點 進行帶有 Authorization: Bearer 標頭的 POST 請求。

🔑 必要前提

你必須在 Slack 應用程式的 OAuth 範圍內包含 chat:write ：

設定步驟

前往 https://api.slack.com/apps
建立應用程式或選擇現有應用程式
在「OAuth & Permissions」 > Scopes 中 → 新增 chat:write
點擊「Install to Workspace」或「Reinstall」以獲取 Access Token（例如：xoxb-xxxxxxxxxx）

💻 C++ 程式碼（使用 WinHTTP 向 Slack API 發送請求）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72


#include <windows.h>
#include <winhttp.h>
#include <iostream>

#pragma comment(lib, "winhttp.lib")

bool PostSlackMessage(const std::wstring& accessToken, const std::string& channel, const std::string& text) {
 const wchar_t* host = L"slack.com";
 const wchar_t* path = L"/api/chat.postMessage";

 HINTERNET hSession = WinHttpOpen(L"SlackPoster/1.0",
 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
 WINHTTP_NO_PROXY_NAME,
 WINHTTP_NO_PROXY_BYPASS, 0);
 if (!hSession) return false;

 HINTERNET hConnect = WinHttpConnect(hSession, host, INTERNET_DEFAULT_HTTPS_PORT, 0);
 if (!hConnect) return false;

 HINTERNET hRequest = WinHttpOpenRequest(hConnect, L"POST", path,
 NULL, WINHTTP_NO_REFERER,
 WINHTTP_DEFAULT_ACCEPT_TYPES,
 WINHTTP_FLAG_SECURE);

 // Authorization 標頭與 Content-Type
 std::wstring headers = L"Content-Type: application/json\r\n";
 headers += L"Authorization: Bearer " + accessToken + L"\r\n";

 // JSON 內容
 std::string body = R"({"channel":")" + channel + R"(","text":")" + text + R"("})";

 BOOL result = WinHttpSendRequest(hRequest,
 headers.c_str(),
 (DWORD)-1,
 (LPVOID)body.c_str(),
 body.length(),
 body.length(),
 0);

 if (!result || !WinHttpReceiveResponse(hRequest, NULL)) {
 std::cerr << "發送錯誤\n";
 return false;
 }

 // 確認狀態碼
 DWORD statusCode = 0;
 DWORD size = sizeof(statusCode);
 WinHttpQueryHeaders(hRequest,
 WINHTTP_QUERY_STATUS_CODE | WINHTTP_QUERY_FLAG_NUMBER,
 WINHTTP_HEADER_NAME_BY_INDEX,
 &statusCode, &size, WINHTTP_NO_HEADER_INDEX);

 WinHttpCloseHandle(hRequest);
 WinHttpCloseHandle(hConnect);
 WinHttpCloseHandle(hSession);

 return (statusCode == 200);
}

int main() {
 std::wstring token = L"xoxb-你的存取權杖"; // 存取權杖
 std::string channel = "頻道ID或者#general"; // 範例: "#general" 或 "C0123456789"
 std::string message = "嘗試從 C++ 發送訊息到 Slack！";

 if (PostSlackMessage(token, channel, message)) {
 std::cout << "發文成功！\n";
 } else {
 std::cerr << "發文失敗。\n";
 }

 return 0;
}

📌 如何獲取頻道 ID

僅使用頻道名稱（例如：#general）可能會導致錯誤。最可靠的方法是使用 Slack 頻道頁面 URL 中的 ID。

1
2


https://app.slack.com/client/Txxxxx/C0123456789
 ↑這部分就是頻道 ID

✅ 關於權杖類型（補充）

權杖格式	用途	範例
`xoxb-...`	Bot Token（推薦）	發文、編輯、刪除
`xoxp-...`	User Token（不推薦）	非 Bot 相關操作
Refresh Token	用於長期權杖更新	通常不使用

📝 總結

要從 C++ 發文到 Slack，使用 Slack Web API + Bearer Token 方式最為可靠
使用 HTTPS POST 發送至 chat.postMessage 端點
必須透過 Bearer 標頭發送權杖
確保 指定頻道 ID 以確保準確性

使用 C++（Win32 API + WinHTTP）發送訊息至 Slack 的方法【支援 Webhook】

Wed, 16 Jul 2025 19:42:56 +0900

使用 C++（Win32 API + WinHTTP）發送訊息至 Slack 的方法【支援 Webhook】

想要從 C++ 發送訊息到 Slack。在 Node.js 或 Python 中這很常見，但使用「C++ × Win32 API × WinHTTP」來做的情況應該很少見吧。

這篇文章將以循序漸進的方式，淺顯易懂地解說 如何使用 Webhook URL 從 C++ 發送訊息到 Slack 。

✅ 整體流程

要發布到 Slack，需要遵循以下步驟。

取得 Slack 的 Webhook URL（API 金鑰）
使用 WinHTTP 發送 POST 請求
以 JSON 格式建立訊息主體
檢查結果即可完成！

🔑 Step1：取得 Slack Webhook URL 的方法

在 Slack 中，可以使用 Incoming Webhooks 的功能，輕鬆地從外部服務發送訊息。

取得步驟

進入 https://api.slack.com/apps
點擊 Create New App
選擇 From scratch 並選擇應用程式名稱與發布目標工作區
從左側選單選擇 「Incoming Webhooks」 並啟用
點擊 「Add New Webhook to Workspace」 ，然後選擇頻道
複製發行的 URL（例如: https://hooks.slack.com/services/xxx/yyy/zzz）

這個 URL 將如同 API 金鑰般發揮作用。

💻 Step2：使用 C++ 程式碼發送訊息至 Slack

使用技術

Win32 API
WinHTTP（標準函式庫）
JSON 格式訊息

範例程式碼（發佈至 Slack）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82


#include <windows.h>
#include <winhttp.h>
#include <iostream>

#pragma comment(lib, "winhttp.lib")

bool PostToSlack(const std::wstring& webhookUrl, const std::string& messageJson) {
 // 解析 URL
 URL_COMPONENTS urlComp{};
 wchar_t hostName[256];
 wchar_t urlPath[1024];

 urlComp.dwStructSize = sizeof(urlComp);
 urlComp.lpszHostName = hostName;
 urlComp.dwHostNameLength = _countof(hostName);
 urlComp.lpszUrlPath = urlPath;
 urlComp.dwUrlPathLength = _countof(urlPath);

 if (!WinHttpCrackUrl(webhookUrl.c_str(), 0, 0, &urlComp)) {
 std::wcerr << L"URL 解析失敗\n";
 return false;
 }

 // HTTP 階段與連線
 HINTERNET hSession = WinHttpOpen(L"SlackPoster/1.0",
 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
 WINHTTP_NO_PROXY_NAME,
 WINHTTP_NO_PROXY_BYPASS, 0);
 HINTERNET hConnect = WinHttpConnect(hSession, hostName, urlComp.nPort, 0);
 HINTERNET hRequest = WinHttpOpenRequest(hConnect, L"POST", urlPath,
 NULL, WINHTTP_NO_REFERER,
 WINHTTP_DEFAULT_ACCEPT_TYPES,
 WINHTTP_FLAG_SECURE);

 std::wstring headers = L"Content-Type: application/json\r\n";
 BOOL result = WinHttpSendRequest(hRequest,
 headers.c_str(),
 -1,
 (LPVOID)messageJson.c_str(),
 messageJson.length(),
 messageJson.length(),
 0);

 if (!result) {
 std::cerr << "發送請求失敗\n";
 return false;
 }

 WinHttpReceiveResponse(hRequest, NULL);

 DWORD statusCode = 0;
 DWORD size = sizeof(statusCode);
 WinHttpQueryHeaders(hRequest,
 WINHTTP_QUERY_STATUS_CODE | WINHTTP_QUERY_FLAG_NUMBER,
 WINHTTP_HEADER_NAME_BY_INDEX,
 &statusCode, &size, WINHTTP_NO_HEADER_INDEX);

 // 釋放資源
 WinHttpCloseHandle(hRequest);
 WinHttpCloseHandle(hConnect);
 WinHttpCloseHandle(hSession);

 return (statusCode == 200);
}

int main() {
 std::wstring webhookUrl = L"https://hooks.slack.com/services/xxx/yyy/zzz"; // 請替換成自己的 Webhook

 std::string message = R"({
 "text": "Hello from C++ :rocket:",
 "username": "C++ Bot",
 "icon_emoji": ":robot_face:"
 })";

 if (PostToSlack(webhookUrl, message)) {
 std::cout << "發布成功！\n";
 } else {
 std::cerr << "發布失敗。\n";
 }

 return 0;
}

🧪 自訂 JSON 訊息

在 Slack 的 Webhook 中，可以包含以下參數：

1
2
3
4
5
6


{
 "text": "通知內容",
 "username": "Bot 名稱",
 "icon_emoji": ":rocket:",
 "channel": "#任意頻道名稱"
}

📌 補充事項

Content-Type 必須指定為 "application/json"
Webhook URL 直接以 wstring 傳遞即可（無需 URL 編碼）
因為是 HTTPS 通訊，請別忘了加上 WINHTTP_FLAG_SECURE

🎉 附錄：Slack 中的發布確認範例

在 Slack 中會這樣顯示：

1
2


[C++ Bot]
Hello from C++ :rocket:

✍️ 總結

項目	內容
發布方式	Webhook (Incoming Webhooks)
通訊函式庫	WinHTTP
資料格式	JSON
可用參數	text, username, icon_emoji, channel 等

還在想著怎麼用 C++ 整合 Slack 嗎？你也可以從今天開始加入通知 Bot！

🚀 下集預告？

如果您有興趣，下次我們可以：

檔案附件
帶按鈕的 UI
使用 Slack App + OAuth2 進行靈活的 API 操作

等，為您介紹更進一步的 Slack 整合！

Win32 API on kenji.blog

如何從 C++ 呼叫 Microsoft.Windows.AI

🎯 如何從 C++ 呼叫 Microsoft.Windows.AI【附範例程式碼】

✅ 準備篇

◾ 系統需求

✅ 專案結構

✅ 範例程式碼

main.cpp

✅ 補充：如何指定輸入與輸出 Tensor

✅ 偵錯時的注意事項

✅ 總結

✅ 替代方案：給不想使用 WinRT 的人

📌 結語

如何使用 Slack App + OAuth2 發送訊息到 Slack

✅ 使用存取權杖的發文方法（Slack Web API）

🔑 必要前提

設定步驟

💻 C++ 程式碼（使用 WinHTTP 向 Slack API 發送請求）

📌 如何獲取頻道 ID

✅ 關於權杖類型（補充）

📝 總結

使用 C++（Win32 API + WinHTTP）發送訊息至 Slack 的方法【支援 Webhook】

使用 C++（Win32 API + WinHTTP）發送訊息至 Slack 的方法【支援 Webhook】

✅ 整體流程

🔑 Step1：取得 Slack Webhook URL 的方法

取得步驟

💻 Step2：使用 C++ 程式碼發送訊息至 Slack

使用技術

範例程式碼（發佈至 Slack）

🧪 自訂 JSON 訊息

📌 補充事項

🎉 附錄：Slack 中的發布確認範例

✍️ 總結

🚀 下集預告？

🎯 如何從 C++ 呼叫 `Microsoft.Windows.AI`【附範例程式碼】

`main.cpp`