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;
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. |
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.
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.