dsGetSiteNameA 函数 (dsgetdc.h)

DsGetSiteName 函数返回计算机所在的站点的名称。对于域控制器 (DC) ，站点的名称是配置的 DC 的位置。对于成员工作站或成员服务器，名称指定计算机域中配置的工作站站点。

语法

DSGETDCAPI DWORD DsGetSiteNameA(
  [in]  LPCSTR ComputerName,
  [out] LPSTR  *SiteName
);

[in] ComputerName

指向以 null 结尾的字符串的指针，该字符串指定要发送此函数的服务器的名称。 NULL 表示本地计算机。

[out] SiteName

指向变量的指针，该变量接收指向以 null 结尾的字符串的指针，该字符串指定此计算机的站点位置。此字符串由系统分配，必须使用 NetApiBufferFree 函数释放。

如果函数返回帐户信息，则返回值 NO_ERROR。

如果函数失败，则返回值可能是以下错误代码之一。

DsGetSiteName 函数不需要对指定域的任何特定访问权限。函数将发送到 ComputerName 指定的计算机上的“NetLogon”服务。

注意

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