3.1.4.3.2.36 CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_REPLICA_VOLUMES

  • Article

The CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_REPLICA_VOLUMES resource type control code SHOULD<190> retrieve the volumes on a given source disk and a given target disk that can be paired for storage replication.

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

The server SHOULD accept CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_REPLICA_VOLUMES 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 client MUST provide in the buffer designated by the lpInBuffer parameter a Property List (section 2.2.3.10) containing two Property Values section 2.2.3.10.1). The first value MUST have as name the null-terminated Unicode string "SourceResourceId". The syntax of this value MUST be set to CLUSPROP_SYNTAX_LIST_VALUE_SZ and the property value buffer MUST contain a null-terminated Unicode string containing the resource ID of the storage replication source disk. The second value MUST have as name the null-terminated Unicode string "TargetResourceId". The syntax of this value MUST be set to CLUSPROP_SYNTAX_LIST_VALUE_SZ and the property value buffer MUST contain a null-terminated Unicode string containing the resource ID of the storage replication target disk.

Upon successful completion of this method, the server MUST provide in the buffer designated by the lpOutBuffer parameter a Property List containing two properties. The first property MUST have as name the null-terminated Unicode string "SourceVolumes", and the second property MUST have as name the null-terminated Unicode string "TargetVolumes". These two properties MUST contain the same number of PropertyValue structures. The PropertyValue structures MUST be ordered such that the first structure in the "SourceVolumes" list represents a volume that can be paired with the volume represented by the first structure in the "TargetVolumes" list, and so on. The PropertyValue structures MUST have syntax set to CLUSPROP_SYNTAX_LIST_VALUE_SZ, and the buffer MUST contain the null-terminated Unicode name of the volume in the volume GUID format. For example: 

 \\?\Volume{00000000-0000-0000-0000-000000000000}\