Share via

3.1.4.3.1.63 CLUSCTL_RESOURCE_NETNAME_SET_PWD_INFOEX

  • Article

This control code is only applicable for ClusApi Protocol Version 3.0.

The CLUSCTL_RESOURCE_NETNAME_SET_PWD_INFOEX resource control code updates information about the designated associated security principals of the resource.

The server MUST fail this method by using error code 0x00000001 (ERROR_INVALID_FUNCTION) if the designated type of the resource does not support the functionality of an alternate computer name with an associated security principal. The server MUST fail this method if the designated resource is not in the ClusterResourceOffline state.

The client provides a CLUS_NETNAME_PWD_INFOEX structure, as specified in section 2.2.3.62, in the buffer that is designated by lpInBuffer.

If nInBufferSize is less than the size of CLUS_NETNAME_PWD_INFOEX structure, the server MUST fail the request with ERROR_INVALID_PARAMETER.

If the length of the new password in Password field in CLUS_NETNAME_PWD_INFOEX structure is greater than 127, the server MUST fail the request with ERROR_PASSWORD_RESTRICTION.

Prior to invoking this method, the client uses implementation-specific mechanisms to ensure that the state of the associated security principal on a directory server is consistent with the data provided in the CLUS_NETNAME_PWD_INFOEX input data structure. If the provided CLUS_NETNAME_PWD_INFOEX input data structure is not consistent with the associated security principal on a directory server, then the server MUST still complete the method (assuming no other failure conditions are met), but the server SHOULD subsequently fail to bring the designated resource online.