SHGLOBALCOUNTER 列舉 (shlwapi.h)

發行項
03/05/2024

各種全域計數器或共用變數的標識碼。每個全域計數器都可以使用 SHGlobalCounterIncrement 和 SHGlobalCounterDecrement遞增或遞減。

Syntax

typedef enum {
  GLOBALCOUNTER_SEARCHMANAGER,
  GLOBALCOUNTER_SEARCHOPTIONS,
  GLOBALCOUNTER_FOLDERSETTINGSCHANGE,
  GLOBALCOUNTER_RATINGS,
  GLOBALCOUNTER_APPROVEDSITES,
  GLOBALCOUNTER_RESTRICTIONS,
  GLOBALCOUNTER_SHELLSETTINGSCHANGED,
  GLOBALCOUNTER_SYSTEMPIDLCHANGE,
  GLOBALCOUNTER_OVERLAYMANAGER,
  GLOBALCOUNTER_QUERYASSOCIATIONS,
  GLOBALCOUNTER_IESESSIONS,
  GLOBALCOUNTER_IEONLY_SESSIONS,
  GLOBALCOUNTER_APPLICATION_DESTINATIONS,
  __UNUSED_RECYCLE_WAS_GLOBALCOUNTER_CSCSYNCINPROGRESS,
  GLOBALCOUNTER_BITBUCKETNUMDELETERS,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_SHARES,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_A,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_B,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_C,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_D,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_E,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_F,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_G,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_H,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_I,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_J,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_K,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_L,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_M,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_N,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_O,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_P,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Q,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_R,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_S,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_T,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_U,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_V,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_W,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_X,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Y,
  GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Z,
  __UNUSED_RECYCLE_WAS_GLOBALCOUNTER_RECYCLEDIRTYCOUNT_SERVERDRIVE,
  __UNUSED_RECYCLE_WAS_GLOBALCOUNTER_RECYCLEGLOBALDIRTYCOUNT,
  GLOBALCOUNTER_RECYCLEBINENUM,
  GLOBALCOUNTER_RECYCLEBINCORRUPTED,
  GLOBALCOUNTER_RATINGS_STATECOUNTER,
  GLOBALCOUNTER_PRIVATE_PROFILE_CACHE,
  GLOBALCOUNTER_INTERNETTOOLBAR_LAYOUT,
  GLOBALCOUNTER_FOLDERDEFINITION_CACHE,
  GLOBALCOUNTER_COMMONPLACES_LIST_CACHE,
  GLOBALCOUNTER_PRIVATE_PROFILE_CACHE_MACHINEWIDE,
  GLOBALCOUNTER_ASSOCCHANGED,
  GLOBALCOUNTER_APP_ITEMS_STATE_STORE_CACHE,
  GLOBALCOUNTER_SETTINGSYNC_ENABLED,
  GLOBALCOUNTER_APPSFOLDER_FILETYPEASSOCIATION_COUNTER,
  GLOBALCOUNTER_USERINFOCHANGED,
  GLOBALCOUNTER_SYNC_ENGINE_INFORMATION_CACHE_MACHINEWIDE,
  GLOBALCOUNTER_BANNERS_DATAMODEL_CACHE_MACHINEWIDE,
  GLOBALCOUNTER_MAXIMUMVALUE
} SHGLOBALCOUNTER;

常數


`GLOBALCOUNTER_SEARCHMANAGER` 要與 ISearchManager 搭配使用的全域計數器。
`GLOBALCOUNTER_SEARCHOPTIONS` 與 ISearchQueryHelper 搭配使用的全域計數器，用來識別查詢剖析器的設定是否已變更。
`GLOBALCOUNTER_FOLDERSETTINGSCHANGE` 用來識別資料夾設定是否已變更的全域計數器。
`GLOBALCOUNTER_RATINGS` 用來識別評等是否已變更的全域計數器。
`GLOBALCOUNTER_APPROVEDSITES` 用來識別核准的網站是否已變更的全域計數器。
`GLOBALCOUNTER_RESTRICTIONS` 用來識別限制是否已變更的全域計數器。
`GLOBALCOUNTER_SHELLSETTINGSCHANGED` 用來識別殼層設定是否已變更的全域計數器。
`GLOBALCOUNTER_SYSTEMPIDLCHANGE` 用來識別系統 PIDL 是否已變更的全域計數器。
`GLOBALCOUNTER_OVERLAYMANAGER` 用來識別重疊管理員狀態是否已變更的全域計數器。
`GLOBALCOUNTER_QUERYASSOCIATIONS` 用來識別查詢關聯是否已變更的全域計數器。
`GLOBALCOUNTER_IESESSIONS` 用來識別 IE 會話數目是否已變更的全域計數器。
`GLOBALCOUNTER_IEONLY_SESSIONS` 用來識別 IE 會話數目是否已變更的全域計數器。
`GLOBALCOUNTER_APPLICATION_DESTINATIONS` 識別用來識別應用程式是否已從系統新增或移除的全域計數器。
`__UNUSED_RECYCLE_WAS_GLOBALCOUNTER_CSCSYNCINPROGRESS` 未使用的。
`GLOBALCOUNTER_BITBUCKETNUMDELETERS` 用來識別回收站刪除的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_SHARES` 用來識別共用上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_A` 用來識別磁碟驅動器 A 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_B` 用來識別磁碟驅動器 B 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_C` 用來識別磁碟驅動器 C 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_D` 用來識別磁碟驅動器 D 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_E` 用來識別磁碟驅動器 E 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_F` 用來識別磁碟驅動器 F 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_G` 用來識別磁碟驅動器 G 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_H` 用來識別磁碟驅動器 H 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_I` 用來識別磁碟驅動器 I 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_J` 用來識別磁碟驅動器 J 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_K` 用來識別磁碟驅動器 K 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_L` 用來識別磁碟驅動器 L 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_M` 用來識別磁碟驅動器 M 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_N` 用來識別磁碟驅動器 N 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_O` 用來識別磁碟驅動器 O 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_P` 用來識別磁碟驅動器 P 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Q` 用來識別磁碟驅動器 Q 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_R` 用來識別磁碟驅動器 R 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_S` 用來識別磁碟驅動器 S 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_T` 用來識別磁碟驅動器 T 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_U` 用來識別磁碟驅動器 U 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_V` 用來識別磁碟驅動器 V 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_W` 用來識別磁碟驅動器 W 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_X` 用來識別磁碟驅動器 X 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Y` 用來識別磁碟驅動器 Y 上設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Z` 用來識別磁碟驅動器 Z 上設定是否已變更的全域計數器。
`__UNUSED_RECYCLE_WAS_GLOBALCOUNTER_RECYCLEDIRTYCOUNT_SERVERDRIVE` 未使用的。
`__UNUSED_RECYCLE_WAS_GLOBALCOUNTER_RECYCLEGLOBALDIRTYCOUNT` 未使用的。
`GLOBALCOUNTER_RECYCLEBINENUM` 用來識別回收站設定是否已變更的全域計數器。
`GLOBALCOUNTER_RECYCLEBINCORRUPTED` 用來識別回收站是否已刪除的全域計數器。
`GLOBALCOUNTER_RATINGS_STATECOUNTER` 用來識別評等是否已變更的全域計數器。
`GLOBALCOUNTER_PRIVATE_PROFILE_CACHE` 全域計數器狀態。
`GLOBALCOUNTER_INTERNETTOOLBAR_LAYOUT` 用來識別因特網工具列配置是否已變更的全域計數器。
`GLOBALCOUNTER_FOLDERDEFINITION_CACHE` 用來識別資料夾定義快取變更的全域計數器。
`GLOBALCOUNTER_COMMONPLACES_LIST_CACHE` 用來識別通用清單快取狀態變更的全域計數器。
`GLOBALCOUNTER_PRIVATE_PROFILE_CACHE_MACHINEWIDE` 全域計數器狀態，全機器。
`GLOBALCOUNTER_ASSOCCHANGED` 用來識別目前 globalAssocChangedCounter 登錄值的全域計數器，用於 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer。
`GLOBALCOUNTER_APP_ITEMS_STATE_STORE_CACHE` Windows 8 中引進。用來識別市集是否為目前狀態的全域計數器。
`GLOBALCOUNTER_SETTINGSYNC_ENABLED` Windows 8 中引進。用來判斷是否啟用或停用同步處理的全域計數器。
`GLOBALCOUNTER_APPSFOLDER_FILETYPEASSOCIATION_COUNTER` Windows 8 中引進。用來識別目前 FTACounter 登錄值的全域計數器，用於 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\ImmersiveShell\StateStore。
`GLOBALCOUNTER_USERINFOCHANGED` Windows 8 中引進。用來識別使用者資訊變更狀態的全域計數器。
`GLOBALCOUNTER_SYNC_ENGINE_INFORMATION_CACHE_MACHINEWIDE` Windows 8.1 引進。用來識別同步處理引擎計數器狀態的全域計數器，計算機範圍。
`GLOBALCOUNTER_BANNERS_DATAMODEL_CACHE_MACHINEWIDE`
`GLOBALCOUNTER_MAXIMUMVALUE` 任何共用變數都可以擁有的最大值。

備註

這些全域計數器是共用變數，可協助識別 Windows 元件的狀態是否隨著時間而變更。它們可以搭配這些函式使用： SHGlobalCounterDecrement、 SHGlobalCounterIncrement、 SHGlobalCounterGetValue。

例子

下列虛擬程式代碼範例示範如何使用全域計數器。

void ValidateSomeSettings()
    {
        // Get the current GLOBALCOUNTER_SHELLSETTINGSCHANGED value.
        long lGlobalSettingsCounter = SHGlobalCounterGetValue(GLOBALCOUNTER_SHELLSETTINGSCHANGED);
            
        // Do some other work
        ...
    
        // Verify whether the Shell settings have changed since entering this method.
        if (lGlobalSettingsCounter == SHGlobalCounterGetValue(GLOBALCOUNTER_SHELLSETTINGSCHANGED))
        {
            // Commit the work that was done earlier 
            ...
        }
    
        else
        {
            // Shell settings have changed. Rollback and redo.
            ...
        }
    }

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
標頭	shlwapi.h

另請參閱

SHGlobalCounterDecrement

SHGlobalCounterGetValue

SHGlobalCounterIncrement

共用方式為

SHGLOBALCOUNTER 列舉 (shlwapi.h)

Syntax

常數

備註

例子

規格需求

另請參閱

意見反應

其他資源