DsGetSiteNameA function

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.

Syntax

DSGETDCAPI DWORD DsGetSiteNameA(
  IN LPCSTR ComputerName OPTIONAL,
  OUT LPSTR              *SiteName
);

Parameters

OPTIONAL

TBD

SiteName

Pointer to a variable that receives a pointer to a null-terminated string specifying the site location of this computer. This string is allocated by the system and must be freed using the NetApiBufferFree function.

Return Value

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.

Remarks

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.

Requirements

   
Windows version Windows Vista Windows Server 2008
Target Platform Windows
Header dsgetdc.h
Library Netapi32.lib
DLL Netapi32.dll

See Also

Directory Service Functions

DsGetDcName

DsValidateSubnetName

NetApiBufferFree