CLUSPROP_REQUIRED_DEPENDENCY union (clusapi.h)

Article
02/22/2024

Describes a resource that is a required dependency of another resource. 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.

Syntax

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 name.

ResClass

Resource class upon which a resource must depend. One of the following values are valid.

CLUS_RESCLASS_UNKNOWN (0)

A resource has a dependency on a resource of an unknown class.

CLUS_RESCLASS_STORAGE (1)

A resource has a dependency on a storage device, such as a Physical Disk resource.

CLUS_RESCLASS_NETWORK (2)

A resource has a dependency on a network device.

CLUS_RESCLASS_USER (32768)

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

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, such as "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".

Examples

See Creating Value Lists.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Header	clusapi.h