CLUSCTL_RESOURCE_DELETE control code
Internal. Used by the Cluster service to notify a resource DLL that a resource it is managing is about to be deleted from the cluster. Resource DLLs receive this control code as a ResourceControl parameter. Because the control code is internal, applications cannot use it in a control code function.
Parameters
This control code has no parameters.
Return value
This control code does not return a value.
Remarks
ClusAPI.h defines the 32 bits of CLUSCTL_RESOURCE_DELETE as follows (for more information, see Control Code Architecture).
| Component | Bit location | Value |
|---|---|---|
| Object code | 24 31 | CLUS_OBJECT_RESOURCE (0x1) |
| Global bit | 23 | CLUS_NOT_GLOBAL (0x0) |
| Modify bit | 22 | CLUS_MODIFY (0x1) |
| User bit | 21 | CLCTL_CLUSTER_BASE (0x0) |
| Type bit | 20 | Internal (0x1) |
| Operation code | 0 23 | CLCTL_DELETE (0x500006) |
| Access code | 0 1 | CLUS_ACCESS_WRITE (0x2) |
Resource DLL Support
Optional. Supporting the CLUSCTL_RESOURCE_DELETE control code allows you to perform any cleanup tasks that may be necessary before the deletion occurs, such as removing temporary files. Note that the Cluster service allows only offline resources to be deleted. Thus your resource DLL will receive this control code only for resources that are already offline. The Resource Monitor does not provide any default processing.
By default, the CLUSCTL_RESOURCE_DELETE control code is sent only to the resource DLL on the node that currently owns the resource. For information about ensuring that the control code is sent to every node in the cluster, see CLUSCTL_RESOURCE_GET_CHARACTERISTICS.
Note that when your resource DLL receives this notification, the deletion is inevitable. Your DLL cannot prevent any of its resources from being deleted.
For more information on the ResourceControl entry point, see Implementing ResourceControl.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Header |
|