3.1.4.3.2.32 CLUSCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS

The CLUSCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS resource control code SHOULD<186> validate that the server can successfully access the witness using the supplied credentials.

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

The server SHOULD accept CLUSCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS resource control code 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 a PROPERTY_LIST structure, as specified in section 2.2.3.10, in the buffer that is designated by the lpInBuffer parameter. The PROPERTY_LIST MUST contain a property with name "PrimaryToken" whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_SZ, as specified in section 2.2.2.3, followed by a null-terminated Unicode string containing the string representation of an access token. The PROPERTY_LIST MUST also contain a property with name "AccountName" whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_SZ, as specified in section 2.2.2.3, followed by a null-terminated Unicode string containing an account name. The PROPERTY_LIST MUST contain a property with name "EndpointInfo" whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_SZ, as specified in section 2.2.2.3, followed by a null-terminated Unicode string containing the string representation of endpoint information. The representation of the token and how the server uses the token, account name, and endpoint information to access the witness are implementation-specific.

After successful completion of the method, the server SHOULD NOT write any data to the buffer that is designated by the lpOutBuffer parameter.