This topic has not yet been rated - Rate this topic

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

 

 

Send comments about this topic to Microsoft

Build date: 10/26/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.