NCS_FilterChange

Filters out state change callbacks for resources not important to this application.

Syntax

 #include <ncssdk.h> 
  
 NCS_RETURN NCS_FilterChange (
   NCS_HANDLE   Handle, 
   UINT8       *FilterName, 
   UINT32       AddFlag 
 );

Parameters

Handle

(IN) Specifies the handle supplied by NCS.

FilterName

(IN) Points to the case sensitive name of the cluster resources you want to filter out.

AddFlag

(IN) Specifies 1 to add a resource to ignore; 0 to delete a resource from being filtered (that is, stop ignoring the specified cluster resource and pass in its name).

Return Values

Value

Name

Description

0

SUCCESS

NCS_RESOURCE_FOUND on duplicate add.

FAILURE

NCS_RESOURCE_NOT_FOUND on failure of delete.

Remarks

Any time a cluster resource changes state it provides a callback. This function allows you to specify the resources for which you do not want callbacks. NCS_FilterChange can report on up to 10 resources. If you specify none, no filtering takes place . All unimportant resources can be turned off using this function. Use this function with NCS_RESOURCE.

IMPORTANT:Return values are case sensitive.