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 code | Description |
|---|---|
|
Insufficient memory to complete the operation. |
|
The function succeeded. |
Requirements
|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names | DsGetDcSiteCoverageW (Unicode) and DsGetDcSiteCoverageA (ANSI) |
See also
Send comments about this topic to Microsoft
Build date: 10/26/2012