CLUSCTL_RESOURCE_UPGRADE_DLL control code
Allows a setup application to upgrade a resource DLL without stopping the Cluster service. Applications use this control code as a ClusterResourceControl parameter.
ClusterResourceControl(
hResource, // resource handle
hHostNode, // host node
CLUSCTL_RESOURCE_UPGRADE_DLL, // this control code
lpInBuffer, // full path of DLL
cbInBufferSize, // allocated buffer size (bytes)
NULL, // not used
0, // not used
NULL ); // not used
Parameters
The following control code function parameters are specific to this control code. For complete parameter descriptions, see ClusterResourceControl.
-
hResource
-
Handle to any resource supported by the DLL to be upgraded.
-
hHostNode
-
Handle to the node currently hosting hResource. This node is called the upgrading node.
-
lpInBuffer
-
Null-terminated Unicode string specifying the path and filename of the resource DLL to upgrade.
-
cbInBufferSize
-
Specifies the byte size of the input buffer.
Return value
This control code does not return a value.
Remarks
ClusAPI.h defines the 32 bits of CLUSCTL_RESOURCE_UPGRADE_DLL 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_NO_MODIFY (0x0) |
| User bit | 21 | CLCTL_CLUSTER_BASE (0x0) |
| Type bit | 20 | External (0x0) |
| Operation code | 0 23 | CLCTL_RESOURCE_UPGRADE_DLL (0x4000ba) |
| Access code | 0 1 | CLUS_ACCESS_READ (0x1) |
Resource DLL Support
Do not support or use this control code in your resource DLL.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Header |
|