PurgePolicyCacheThread method

This method is deprecated.

Purges data stored in the FESF Policy Cache for a specific process, given a Thread ID associated with that process.

Syntax

HRESULT

PurgePolicyCacheThread(

    [in]  int ThreadId

)

Parameters

ThreadId [in]

The identifier of a thread whose process is to be removed from the FESF Policy Cache, or zero to remove the cached data for all processes from the FESF Policy Cache.

Return value

If the method succeeds, S_OK is returned.

If the method fails for any reason, an appropriate error code is returned.

Remarks

Important: This method is deprecated and is pending removal from FESF. Do not use it. Convert existing code that uses it as soon as possible. Use the equivalent function provided by the FesfUtil2 Library.

A Policy DLL may call this method to cause FESF to remove all references to a given process, or all processes, from its Policy Cache.  Note that there may be some delay between the time this method is called and the Policy Cache is completely purged.

Even though this method takes a Thread ID in the ThreadId parameter, the FESF Policy Cache is purged for all threads in the process that owns the specified thread.  If the ThreadId parameter is passed as zero, the FESF Policy Cache is purged for all threads and all processes.

This method relies on support from the FESF Kernel Mode Components.  Note that methods in the FESF Utility library are only designed for use when FESF is installed and the FESF Kernel Mode Components are running.

For more information, see FESF Policy Caching.

Examples

See Also

Requirements