CLUSPROP_REQUIRED_DEPENDENCY

The CLUSPROP_REQUIRED_DEPENDENCY union describes a resource upon which another resource is required to have a dependency. This union is used as a value in the value list returned from a CLUSCTL_RESOURCE_GET_REQUIRED_DEPENDENCIES or CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES control code operation.

The CLUSPROP_REQUIRED_DEPENDENCY structure is defined in CLUSAPI.H.

typedef union _CLUSPROP_REQUIRED_DEPENDENCY {
    CLUSPROP_VALUE             Value;
    CLUSPROP_RESOURCE_CLASS    ResClass;
    CLUSPROP_SZ                ResTypeName;
} CLUSPROP_REQUIRED_DEPENDENCY, *PCLUSPROP_REQUIRED_DEPENDENCY;
 

Members

Value

CLUSPROP_VALUE structure describing whether the data in the structure is a resource class or resource type.

ResClass

Resource class upon which a resource must depend. A resource class is a numeric value used to identify resources of similar capability. One of the following values are valid:

Resource class value	Description
CLUS_RESCLASS_UNKNOWN	A resource has a dependency on a resource of an unknown class.
CLUS_RESCLASS_STORAGE	A resource has a dependency on a storage device, such as a Physical Disk resource.
CLUS_RESCLASS_USER	A resource has a dependency on a resource belonging to a user-defined class. CLUS_RESCLASS_USER specifies the beginning of the range for user-defined resource classes.

ResTypeName

Resource type upon which a resource must depend, such as IP Address.

Remarks

A CLUSPROP_REQUIRED_DEPENDENCY structure is returned in the value list by ClusterResourceControl when the dwControlCode parameter is set to CLUSCTL_RESOURCE_GET_REQUIRED_DEPENDENCIES, and by ClusterResourceTypeControl when dwControlCode is set to CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES.

The CLUSPROP_REQUIRED_DEPENDENCY structure describes mandatory dependencies. For example, a Print Spooler resource has required dependencies on a storage device and a Network Name resource. The first type of dependency is described using a resource class; storage device resources belong to the CLUS_RESCLASS_STORAGE resource class. The second type of dependency is described using a resource type name, Network Name.

Therefore, when an application calls ClusterResourceControl with the CLUSCTL_RESOURCE_GET_REQUIRED_DEPENDENCIES control code, a value list is returned with two entries: a CLUSPROP_REQUIRED_DEPENDENCY structure with the ResClass member set to CLUS_RESCLASS_STORAGE and a second CLUSPROP_REQUIRED_DEPENDENCY structure with the ResTypeName member set to 'Network Name.'

The Value member is used to determine if the dependency is described with resource class or resource type information.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.