IVsFontAndColorCacheManager.CheckCache(Guid, Int32) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.8.0.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.11.40262

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Determines if a given Category's state is cached and current.

public:
 int CheckCache(Guid % rguidCategory, [Runtime::InteropServices::Out] int % pfHasData);

public int CheckCache (ref Guid rguidCategory, out int pfHasData);

abstract member CheckCache : Guid * int -> int

Public Function CheckCache (ByRef rguidCategory As Guid, ByRef pfHasData As Integer) As Integer

Parameters

rguidCategory: Guid

[in] Specifies the GUID of the Category of Display Items whose caching state is being checked

pfHasData: Int32

[out] Flag indicating if a Category's default Fonts and Colors cache state. If pfHasData is true, the Category's state is current and cached.If pfHasData is false, the Category's state is not cached.

Returns

Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Examples

RESULT hr = S_OK;  
CComPtr<IVsFontAndColorCacheManager> spCacheManager;  
BOOL fCached = FALSE;  

// Check to see if the info for this category is cached, refreshing the cache if necessary.  
if (SUCCEEDED(GetFontColorCacheManager(&spCacheManager)))  
{  
    spCacheManager->CheckCache(rguidCategory, &fCached);  
    if (!fCached && fAllowCacheRefresh && fAllowPackageLoad)  
    {  
        spCacheManager->RefreshCache(rguidCategory);  
        spCacheManager->CheckCache(rguidCategory, &fCached);  
    }  
}

Remarks

If a Category's state is not up to date, the Visual Studio environment clears any of its cached information by calling ClearCache.

COM Signature

From vsshell80.idl:

HRESULT IVsFontAndColorCacheManager::CheckCache(  
   [in] REFGUID rguidCategory,  
   [out] BOOL *pfHasData  
);

Applies to

Share via