CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT

The CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT control code is used to add a registry tree to the list of registry trees that will be replicated for a resource.

Quick Info

Type: External
Access: CLUS_ACCESS_WRITE
Input: Null-terminated Unicode string
Output: None
Global: CLUS_NOT_GLOBAL
Modify: CLUS_MODIFY
Code: CLCTL_ADD_REGISTRY_CHECKPOINT

Notes to Callers

Set the lpInBuffer parameter to point to a string that specifies the registry key name at the root of the subtree that should be replicated for this resource. This is a key name that is relative to HKEY_LOCAL_MACHINE, such as "Software\Microsoft\My Application". A leading backslash character ("\") should not be used with relative paths. If a leading backslash is used in the string passed to ClusterResourceControl in the lpInBuffer parameter, the call will fail.

To delete a registry checkpoint, use the CLUSCTL_RESOURCE_DELETE_REGISTRY_CHECKPOINT control code in your call to ClusterResourceControl.

Notes to Resource DLL Writers

Do not support the CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT control code in your ResourceControl entry point function. Return ERROR_INVALID_FUNCTION to indicate to the Resource Monitor that it should take over the processing.