通过

GetTenantRestrictionsHostnames 函数

  • 项目

GetTenantRestrictionsHostnames 函数返回 (列表hostnames，例如 foo.ca) 和subdomainSupportedHostnames (，例如 .bar.ca) 调用方。 此列表由 Windows 保持同步，并由应用用于向这些终结点应用 租户限制 。

语法

STDAPI GetTenantRestrictionsHostnames(
  _Out_  LPWSTR**  hostnames,
  _Out_  UINT32*   hostnameCount,
  _Out_  LPWSTR**  subdomainSupportedHostnames,
  _Out_  UINT32*   subdomainSupportedHostnameCount
);

parameters

hostnames [out]

主机名 包含必须完全匹配的名称。 例如，如果 foo.ca 在列表中，则 foo.ca应 受租户限制的约束，但 bar.foo.ca不应。

hostnameCount [out]

hostnameCount 参数包含数组中的hostnames主机名数。

subdomainSupportedHostnames [out]

subdomainSupportedHostnames 包含允许子域的名称，例如，如果 .bar.ca 位于列表中， sub.bar.ca则应 受租户限制的约束，但 bar.ca不应受其约束。 这些条目应具有前面的 . ，以便于匹配。

subdomainSupportedHostnameCount [out]

subdomainSupportedHostnameCount 参数包含数组中的subdomainSupportedHostnames主机名数。

返回值

如果函数成功，则函数返回 S_OK。

注解

调用方应使用 CoTaskMemFree 以迭代方式释放数组条目，然后释放数组本身。

关于空数组：

  • 这两个列表都为空) ，这是有效的 (但实际上并不预期。
  • 一个列表包含条目有效，而另一个列表不包含条目。

在任一情况下，都不需要取消分配空列表。 如果返回值不是 S_OK，则无需取消分配。

该函数不返回 以外的 S_OK成功值。

此函数没有关联的导入库或头文件;必须使用 LoadLibrary 和 GetProcAddress 函数调用它。

要求

要求 值
最低受支持的客户端 Windows 10版本 2004 [仅限桌面应用]
最低受支持的服务器 Windows Server 版本 2004 [仅限桌面应用]
DLL TenantRestrictionsPlugin.dll