Share via

3.1.4.3.2.37 CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_LOG_VOLUME

  • Article

The CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_LOG_VOLUME resource type control code SHOULD<191> retrieve the path where log data can be written given a source or target disk and a log disk.

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

The server accepts CLUSCTL_RESOURCE_TYPE_REPLICATION_GET_LOG_VOLUME 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 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 "DataResourceId". 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 disk (either source or target) for which the log path is being queried. The second value MUST have as name the null-terminated Unicode string "LogResourceId". 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 log disk.

Upon successful completion of this method, the server MUST provide in the buffer designated by the lpOutBuffer parameter a Property List containing one Property Value. The value MUST have as name the null-terminated Unicode string "LogVolume". 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 path at which log data can be written.