Platform SDK: Active Directory, ADSI, and Directory Services

DsGetDcSiteCoverage

The DsGetDcSiteCoverage function returns the site names of all sites covered by a domain controller.

DWORD DsGetDcSiteCoverage(
  LPCSTR ServerName,
  PULONG EntryCount
  LPSTR **SiteNames
);

Parameters

ServerName
[in, optional] Specifies the name of the remote domain controller.
EntryCount
[out] Returns the number of sites covered by the domain controller.
**SiteNames
[out] Returns an array of pointers to site names. The returned buffer must be deallocated using NetApiBufferFree.

Return Values

Value Meaning
ERROR_NOT_ENOUGH_MEMORY There was not enough memory to complete the operation.
NO_ERROR Success

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsgetdc.h.
  Library: Included as a resource in Ntdsapi.dll.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

DsGetSiteName