CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_32BIT control code

Adds a registry tree using the 32-bit view of the registry to the list of registry trees that are replicated for a resource. Applications use this control code as a parameter in the ClusterResourceControl function.

ClusterResourceControl( 
  hResource,                                      // resource handle
  hHostNode,                                      // optional host node
  CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_32BIT, // this control code
  lpInBuffer,                                     // input buffer: string
  cbInBufferSize,                                 // input buffer size (bytes)
  NULL,                                           // not used
  0,                                              // not used
  NULL );                                         // not used

Parameters

The following control code function parameter is specific to this control code. For complete parameter descriptions, see ClusterResourceControl.

lpInBuffer

A pointer to a null-terminated Unicode string that contains the registry key name in the 32-bit view of the registry at the root of the subtree that should be replicated for the resource. This is a key name that is relative to HKEY_LOCAL_MACHINE, such as Software\Microsoft\My Application. Do not use a leading backslash (\) in the relative path or the call will fail.

Return value

ClusterResourceControl returns one of the following values:

ERROR_SUCCESS

The operation was successful.

ERROR_ALREADY_EXISTS

The specified key is already being checkpointed.

System error code

The operation failed.

Remarks

ClusApi.h defines the 32 bits of CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_32BIT as follows (for more information, see Control Code Architecture).

Resource DLL Support

The CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_32BIT control code is handled by the Cluster service and is not passed to resource DLLs.

Requirements

See also

CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT

CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_64BIT

CLUSCTL_RESOURCE_DELETE_REGISTRY_CHECKPOINT

CLUSCTL_RESOURCE_GET_REGISTRY_CHECKPOINTS

ClusterResourceControl

ResourceControl

Send comments about this topic to Microsoft

Build date: 11/28/2012