The NetGetAnyDCName function gets the name of any domain controller for a domain that is directly trusted by the server name.
Security Requirements
No special group membership is required to successfully execute NetGetAnyDCName.
NET_API_STATUS NetGetAnyDCName(
| LPCWSTR ServerName, |
| LPCWSTR DomainName, |
| OUT LPBYTE * Buffer |
| ); |
Parameters
ServerName
Pointer to a null-terminated Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.
DomainName
Specifies the name of domain (null for primary domain)
Buffer
Returns a pointer to an allocated buffer containing the server name of a domain controller for the domain. The server name is prefixed by \\. The buffer should be deallocated using NetApiBufferFree.
Remarks
If ServerName is a standalone Windows NT Workstation or standalone Windows NT Server, no DomainName is valid. If ServerName is a Windows NT Workstation that is a member of a domain or a Windows NT Server member, the DomainName must be in the same domain as ServerName. If ServerName is a Windows NT Server domain controller, the DomainName must be one of the domains trusted by the domain for which the server is a controller . The domain controller that this call finds has been operational at least once during this call.
Return Values
If the function succeeds, the return value is NERR_Success.
If the function fails, the return value is one of the following error codes.
| Value | Meaning |
| ERROR_SUCCESS | Buffer successfully contains the name of the domain controller prefixed by \\. |
| ERROR_NO_LOGON_SERVERS | No domain controllers could be found |
| ERROR_NO_SUCH_DOMAIN | The specified domain is not a trusted domain. |
| ERROR_NO_TRUST_LSA_SECRET | The client side of the trust relationship is broken. |
| ERROR_NO_TRUST_SAM_ACCOUNT | The server side of the trust relationship is broken or the password is broken. |
| ERROR_DOMAIN_TRUST_INCONSISTENT | The server that responded is not a proper domain controller of the specified domain. |
See Also