3.1.4.3.2.39 CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_RESOURCE_GROUP

  • Article

The CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_RESOURCE_GROUP resource type control code SHOULD<193> retrieve the cluster groups from the cluster state that contain a storage class resource configured for storage replication.

Protocol version 2.0 servers fail this method using error code 0x00000001 (ERROR_INVALID_FUNCTION).

The server accepts CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_RESOURCE_GROUP resource type control request(s) if its protocol server state is read-only, and the server MUST accept the request for processing if it is in the read/write state, as specified in section 3.1.1.

The buffer that is designated by the lpInBuffer parameter MUST be ignored.

Upon successful completion of this method, the server MUST provide in the buffer designated by the lpOutBuffer parameter a list of PropertyValues structures (section 2.2.3.10.1). Each property value has CLUSPROP_SYNTAX_LIST_VALUE_BINARY syntax as defined in section 2.2.2.3. The buffer contains a PROPERTY_LIST data structure (section 2.2.3.10) containing three properties.

  • The first property is a null-terminated Unicode string named ReplicationGroupId, whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_SZ, with a buffer containing the ID of a replication group as a null-terminated Unicode string.

  • The second property is a the null-terminated Unicode string named ClusterGroupId, whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_SZ, with a buffer containing the ID of a cluster group that contains a storage class resource representing a disk that is in the replication group referenced by the first property.

  • The third property is a null-terminated Unicode string named ReplicationClusterGroupType, whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_DWORD, and data buffer is set to 0x00000000 or 0x00000001, depending on whether the storage class resource in this cluster group represents the target or the source disk for storage replication, respectively.