Freigeben über


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

See also

ClusterResourceControl

DeleteClusterResource

ResourceControl