Share via

3.1.4.3.1.34 CLUSCTL_RESOURCE_NETNAME_DELETE_CO

  • Article

The CLUSCTL_RESOURCE_NETNAME_DELETE_CO resource control code deletes the designated associated security principal of the resource.

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

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.

The client MUST provide the objectGuid in the buffer that is designated by lpInBuffer. The objectGUID MUST be a null-terminated Unicode string of the security principal object on a directory server.

After successful completion of the method, the server SHOULD NOT write any data to the buffer that is designated by lpOutBuffer. After successful completion of this method, the server SHOULD fail subsequent requests to bring the designated resource online, and the client SHOULD delete the resource.

The server SHOULD accept a CLUSCTL_RESOURCE_NETNAME_DELETE_CO resource control code request if its protocol server state is read-only and MUST accept the request for processing if it is in the read/write state, as specified in section 3.1.1.