Platform SDK: Active Directory, ADSI, and Directory Services |
The DsGetSiteName function returns the name of the site where a computer resides. For a domain controller (DC), the name of the site is the location of the configured DC. For a member workstation or member server, the name specifies the workstation site as configured in the domain of the computer.
DWORD DsGetSiteName( LPCTSTR ComputerName, LPTSTR *SiteName );
The DsGetSiteName function does not require any particular access to the specified domain. The function is sent to the Netlogon service on the computer specified by ComputerName.
If the function returns account information, the return value is NO_ERROR.
If the function fails, the return value can be one of the following error codes.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Dsgetdc.h.
Library: Included as a resource in Netapi32.dll.
Unicode: Implemented as Unicode and ANSI versions on Windows 2000.
Directory Service Functions, DsGetDcName, DSValidateSubnetName, NetApiBufferFree