快速偵測 Pocket PC 是否連接 PC：CeRapiInitEx 非阻塞實作

問題背景

Pocket PC SDK 提供 CeRapiInit 檢測連線，但若裝置未連接，該函式會無限期阻塞執行緒，導致程式假死。需使用非阻塞版 CeRapiInitEx 搭配事件等待機制。

API 對比

RAPIINIT 結構

typedef struct _RAPIINIT {
    DWORD cbSize;          // 結構大小
    HANDLE heRapiInit;     // 事件控制代碼，連線完成時觸發
    HRESULT hrRapiInit;    // 實際連線結果
} RAPIINIT;

正確檢測流程

RAPIINIT ri = {0};
ri.cbSize = sizeof(RAPIINIT);

HRESULT hInitResult = CeRapiInitEx(&ri); // 立即返回

// 等待連線事件，設定超時避免無限等待
DWORD dwWaitResult = WaitForSingleObject(ri.heRapiInit, 2000); // 2 秒超時

// 綜合判斷連線是否成功
if (hInitResult == S_OK && ri.hrRapiInit == S_OK && dwWaitResult != WAIT_TIMEOUT) {
    // 連線成功，可進行 RAPI 操作
} else {
    // 連線失敗或超時
    CeRapiUninit(); // 記得清理
}

關鍵參數：超時時間設定經驗值

• 裝置已連接：檢測通常 < 1 秒完成。
• 裝置未連接：最長等待不超過 2 秒。
• 建議 WaitForSingleObject 超時設 2000ms，平衡回應速度與可靠度。

替代等待方式

MSDN 建議 MsgWaitForMultipleObjects 以保持訊息泵運作，但實測 WaitForSingleObject 於工作執行緒中同樣可行且更簡潔。

總結

使用 CeRapiInitEx + WaitForSingleObject 即可實現非阻塞、有超時保護的 Pocket PC 連線偵測，避免主執行緒卡死，提升使用者體驗。