State and Notifications Broker

        State and Notifications Broker提供了一个在注册表中存储系统和应用程序信息的机制和一个存储信息改变的通知系统。它可以用于监控系统中的任何注册表键值。通知种类包括以下几种：

• System state information, such as features present (camera, keyboard), active application, cradled state, battery state.
• Message information, such as count of unread, last received, account info.
• Tasks and appointments information, such as upcoming, overdue, location.
• Windows Media Player information, such as currently playing album, artist.
• Phone information, such as signal information, operator information, call information, multiline information.
• Connections information, related to bluetooth, cellular, network, modem, etc.

•         snapi.h中包含了需要监控的注册表Key、Path、Value Name和Mask，比方说你想知道现在的phone处在一个什么状态，可以看到snapi.h中有这么一段：

  
  // PhoneRoaming
  // Gets a value indicating whether the phone is currently in roaming mode.
  #define SN_PHONEROAMING_ROOT HKEY_LOCAL_MACHINE
  #define SN_PHONEROAMING_PATH TEXT("System//State//Phone")
  #define SN_PHONEROAMING_VALUE TEXT("Status")
  #define SN_PHONEROAMING_BITMASK 0x200

          当键值[HKLM/System/State/Phone] "Status"值的0x200这一位上为1时，说明phone处在漫游状态。

          那么，如何监控注册表键值呢？可以用RegistryNotifyApp、RegistryNotifyWindow、RegistryNotifyCallback等API。以下是Sample Code：

  1. #include <snapi.h>
  2. #include <regext.h>
  4. #define UM_REGNOTIFY    WM_USER+1000
  6. // Global Variables:
  7. HREGNOTIFY          g_hRegNotify;
  9. LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
  10. {
  11.     switch (message) 
  12.     {
  13.         case WM_CREATE:
  14.             NOTIFICATIONCONDITION nc;
  15.             ZeroMemory(&nc, sizeof(NOTIFICATIONCONDITION));
  16.             nc.ctComparisonType = REG_CT_EQUAL;
  17.             nc.dwMask = 0x200;
  18.             nc.TargetValue.dw = 0x200;
  19.             RegistryNotifyWindow(SN_PHONEROAMING_ROOT, SN_PHONEROAMING_PATH, SN_PHONEROAMING_VALUE, hWnd, UM_REGNOTIFY, 0, &nc, &g_hRegNotify);
  20.             break;
  21.         case UM_REGNOTIFY:
  22.             MessageBox(hWnd, _T("Phone is roaming!"), _T("Notification Broker"), MB_OK);
  23.             break;
  24.         case WM_DESTROY:
  25.             RegistryCloseNotification(g_hRegNotify);
  26.             PostQuitMessage(0);
  27.             break;
  29.         default:
  30.             return DefWindowProc(hWnd, message, wParam, lParam);
  31.     }
  32.     return 0;
  33. }