DsGetDcSiteCoverageA 函数（dsgetdc.h）

DsGetDcSiteCoverage 函数返回域控制器涵盖的所有网站的站点名称。

语法

DSGETDCAPI DWORD DsGetDcSiteCoverageA(
  [in, optional] LPCSTR ServerName,
  [out]          PULONG EntryCount,
  [out]          LPSTR  **SiteNames
);

[in, optional] ServerName

指定远程域控制器名称的以 null 结尾的字符串值。

[out] EntryCount

指向 ULONG 值的指针，该值接收域控制器涵盖的站点数。

[out] SiteNames

指向指向接收站点名称的以 null 结尾的字符串的指针数组的指针。若要释放返回的缓冲区，请调用 NetApiBufferFree 函数。

此函数返回 DSGETDCAPI DWORD。

注意

dsgetdc.h 标头将 DsGetDcSiteCoverage 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。