HookAccessControl Class

Provides a managed interface to the native thread ACLs.

Inheritance Hierarchy

SystemObject
EasyHookHookAccessControl

Namespace: EasyHook
Assembly: EasyHook (in EasyHook.dll) Version: 2.7.6684.0 (2.7.6684.0)

Syntax

C++

Copy

public class HookAccessControl

Public Class HookAccessControl

public ref class HookAccessControl

type HookAccessControl =  class end

The HookAccessControl type exposes the following members.

Properties

	Name	Description
	IsExclusive	Is this ACL an exclusive one? Refer to SetExclusiveACL(Int32) for more information.
	IsInclusive	Is this ACL an inclusive one? Refer to SetInclusiveACL(Int32) for more information.

Top

Methods

	Name	Description
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetEntries	Creates a copy of the internal thread list associated with this ACL. You may freely modify it without affecting the internal entries.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	SetExclusiveACL	Sets an exclusive ACL. This means all threads that are enumerated through InACL are NOT intercepted while all others are. Of course this will overwrite the existing ACL.
	SetInclusiveACL	Sets an inclusive ACL. This means all threads that are enumerated through InACL are intercepted while all others are NOT. Of course this will overwrite the existing ACL.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

Refer to the official guide to learn more about why thread ACLs are useful. They can be used to exclude/include dedicated threads from interception or to dynamically apply different kind of hooks to different threads. Even if you could do this in managed code, it is not that easy to implement and also EasyHook evaluates those ACLs in unmanaged code. So if any thread is not intercepted, it will never enter the manged environment what will speed up things about orders of magnitudes.

Reference

EasyHook Namespace