Share via

3.1.4.3.1.57 CLUSCTL_CLOUD_WITNESS_RESOURCE_UPDATE_TOKEN

  • Article

The CLUSCTL_CLOUD_WITNESS_RESOURCE_UPDATE_TOKEN resource control code SHOULD<179> update the token used by the server to authenticate access to the witness.

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_UPDATE_TOKEN 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 representation of the token and how the server uses the token 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.