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
- 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 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
DsGetDcSiteCoverageW (Unicode) and DsGetDcSiteCoverageA (ANSI) |
See also