3.1.4.3.1.59 CLUSCTL_RESOURCE_NETNAME_CHECK_AD_STATE

The CLUSCTL_RESOURCE_NETNAME_CHECK_AD_STATE resource control code SHOULD<181> query status information about the alternate computer name associated with the resource.

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

The server MUST fail this method using ERROR_INVALID_FUNCTION if the designated type of the resource does not support the functionality of an alternate computer name.

The server MUST ignore any data in the buffer designated by the lpInBuffer parameter. Upon successful completion of this method, the server MUST write to the buffer designated by the lpOutBuffer parameter a 32-bit unsigned integer containing the bitwise OR of zero or more of the following values:

Value

Meaning

NETNAME_CHECK_AD_STATE_FLAGS_NO_DCS

0x00000001

The server was unable to contact a directory server.

NETNAME_CHECK_AD_STATE_FLAGS_NO_OBJECT

0x00000002

The alternate computer name security principal associated with the resource was not found on a directory server.

NETNAME_CHECK_AD_STATE_FLAGS_BAD_PWD

0x00000004

The server has an incorrect password for the associated alternate computer name's security principal.

NETNAME_CHECK_AD_STATE_FLAGS_OBJ_DISABLED

0x00000008

The alternate computer name security principal is disabled on a directory server.

The server SHOULD accept a CLUSCTL_RESOURCE_NETNAME_CHECK_OU_PERMISSIONS 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.