NetGetAnyDCName info  Overview  Group

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(

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.

See Also

NetGetDCName