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 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

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