SHGLOBALCOUNTER, énumération (shlwapi.h)

Article
08/26/2023

Identificateurs de différents compteurs globaux ou variables partagées. Chaque compteur global peut être incrémenté ou décrémenté à l’aide de SHGlobalCounterIncrement et 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;

Constantes


`GLOBALCOUNTER_SEARCHMANAGER` Compteur global à utiliser avec ISearchManager.
`GLOBALCOUNTER_SEARCHOPTIONS` Compteur global à utiliser avec ISearchQueryHelper pour identifier si les paramètres d’un analyseur de requête ont changé.
`GLOBALCOUNTER_FOLDERSETTINGSCHANGE` Compteur global utilisé pour identifier si les paramètres de dossier ont changé.
`GLOBALCOUNTER_RATINGS` Compteur global utilisé pour déterminer si les évaluations ont changé.
`GLOBALCOUNTER_APPROVEDSITES` Compteur global utilisé pour identifier si les sites approuvés ont changé.
`GLOBALCOUNTER_RESTRICTIONS` Compteur global utilisé pour déterminer si les restrictions ont changé.
`GLOBALCOUNTER_SHELLSETTINGSCHANGED` Compteur global utilisé pour identifier si les paramètres de l’interpréteur de commandes ont changé.
`GLOBALCOUNTER_SYSTEMPIDLCHANGE` Compteur global utilisé pour identifier si un PIDL système a changé.
`GLOBALCOUNTER_OVERLAYMANAGER` Compteur global utilisé pour identifier si l’état du gestionnaire de superposition a changé.
`GLOBALCOUNTER_QUERYASSOCIATIONS` Compteur global utilisé pour identifier si les associations de requête ont changé.
`GLOBALCOUNTER_IESESSIONS` Compteur global utilisé pour déterminer si le nombre de sessions IE a changé.
`GLOBALCOUNTER_IEONLY_SESSIONS` Compteur global utilisé pour déterminer si le nombre de sessions IE a changé.
`GLOBALCOUNTER_APPLICATION_DESTINATIONS` Identifie le compteur global utilisé pour déterminer si des applications ont été ajoutées ou supprimées du système.
`__UNUSED_RECYCLE_WAS_GLOBALCOUNTER_CSCSYNCINPROGRESS` Inutilisé.
`GLOBALCOUNTER_BITBUCKETNUMDELETERS` Compteur global utilisé pour identifier les suppressions dans la Corbeille.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_SHARES` Compteur global utilisé pour identifier si les paramètres ont changé sur un partage.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_A` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur A.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_B` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur B.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_C` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur C.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_D` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur D.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_E` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur E.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_F` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur F.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_G` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur G.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_H` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur H.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_I` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur I.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_J` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur J.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_K` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur K.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_L` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur L.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_M` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur M.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_N` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur N.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_O` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur O.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_P` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur P.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Q` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur Q.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_R` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur R.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_S` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur S.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_T` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur T.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_U` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur U.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_V` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur V.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_W` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur W.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_X` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur X.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Y` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur Y.
`GLOBALCOUNTER_RECYCLEDIRTYCOUNT_DRIVE_Z` Compteur global utilisé pour identifier si les paramètres ont changé sur le lecteur Z.
`__UNUSED_RECYCLE_WAS_GLOBALCOUNTER_RECYCLEDIRTYCOUNT_SERVERDRIVE` Inutilisé.
`__UNUSED_RECYCLE_WAS_GLOBALCOUNTER_RECYCLEGLOBALDIRTYCOUNT` Inutilisé.
`GLOBALCOUNTER_RECYCLEBINENUM` Compteur global utilisé pour identifier si les paramètres de la Corbeille ont changé.
`GLOBALCOUNTER_RECYCLEBINCORRUPTED` Compteur global utilisé pour identifier si une Corbeille a été supprimée.
`GLOBALCOUNTER_RATINGS_STATECOUNTER` Compteur global utilisé pour déterminer si les évaluations ont changé.
`GLOBALCOUNTER_PRIVATE_PROFILE_CACHE` État du compteur global.
`GLOBALCOUNTER_INTERNETTOOLBAR_LAYOUT` Compteur global utilisé pour identifier si la disposition de la barre d’outils Internet a changé.
`GLOBALCOUNTER_FOLDERDEFINITION_CACHE` Compteur global utilisé pour identifier les modifications apportées au cache de définition de dossier.
`GLOBALCOUNTER_COMMONPLACES_LIST_CACHE` Compteur global utilisé pour identifier les changements d’état pour le cache de liste commonplaces.
`GLOBALCOUNTER_PRIVATE_PROFILE_CACHE_MACHINEWIDE` État du compteur global, à l’échelle de l’ordinateur.
`GLOBALCOUNTER_ASSOCCHANGED` Compteur global utilisé pour identifier la valeur de Registre GlobalAssocChangedCounter actuelle pour HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer.
`GLOBALCOUNTER_APP_ITEMS_STATE_STORE_CACHE` Introduit dans Windows 8. Compteur global utilisé pour déterminer si le Store est actif.
`GLOBALCOUNTER_SETTINGSYNC_ENABLED` Introduit dans Windows 8. Compteur global utilisé pour déterminer si la synchronisation est activée ou désactivée.
`GLOBALCOUNTER_APPSFOLDER_FILETYPEASSOCIATION_COUNTER` Introduit dans Windows 8. Compteur global utilisé pour identifier la valeur de Registre FTACounter actuelle pour HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\ImmersiveShell\StateStore.
`GLOBALCOUNTER_USERINFOCHANGED` Introduit dans Windows 8. Compteur global utilisé pour identifier le changement d’état des informations utilisateur.
`GLOBALCOUNTER_SYNC_ENGINE_INFORMATION_CACHE_MACHINEWIDE` Introduit dans Windows 8.1. Compteur global utilisé pour identifier l’état du compteur du moteur de synchronisation, à l’échelle de la machine..
`GLOBALCOUNTER_BANNERS_DATAMODEL_CACHE_MACHINEWIDE`
`GLOBALCOUNTER_MAXIMUMVALUE` Valeur maximale que toute variable partagée peut avoir.

Remarques

Ces compteurs globaux sont des variables partagées qui peuvent aider à déterminer si l’état d’un composant Windows a changé au fil du temps. Ils peuvent être utilisés avec ces fonctions : SHGlobalCounterDecrement, SHGlobalCounterIncrement, SHGlobalCounterGetValue.

Exemple

L’exemple de pseudocode suivant montre comment utiliser un compteur global.

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.
            ...
        }
    }

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	shlwapi.h

Voir aussi

SHGlobalCounterDecrement

SHGlobalCounterGetValue

SHGlobalCounterIncrement