Export (0) Print
Expand All

DsGetDcSiteCoverage function

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

Syntax


DWORD DsGetDcSiteCoverage(
  _In_opt_  LPCTSTR ServerName,
  _Out_     PULONG EntryCount,
  _Out_     LPTSTR **SiteNames
);

Parameters

ServerName [in, optional]

The null-terminated string value that specifies the name of the remote domain controller.

EntryCount [out]

Pointer to a ULONG value that receives the number of sites covered by the domain controller.

SiteNames [out]

Pointer to an array of pointers to null-terminated strings that receives the site names. To free the returned buffer, call the NetApiBufferFree function.

Return value

Return codeDescription
ERROR_NOT_ENOUGH_MEMORY

Insufficient memory to complete the operation.

NO_ERROR

The function succeeded.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Dsgetdc.h

Library

Netapi32.lib

DLL

Netapi32.dll

Unicode and ANSI names

DsGetDcSiteCoverageW (Unicode) and DsGetDcSiteCoverageA (ANSI)

See also

NetApiBufferFree
DsGetSiteName
Directory Service Functions

 

 

Show:
© 2014 Microsoft