CLUSCTL_RESOURCE_DELETE control code

Article
05/31/2018

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	ClusAPI.h