Функция GetTenantRestrictionsHostnames

  • Статья

Функция GetTenantRestrictionsHostnames возвращает вызывающей объекту список hostnames (например, foo.ca) и subdomainSupportedHostnames (например, .bar.ca). Этот список синхронизируется Windows и используется приложениями для применения ограничений клиента к этим конечным точкам.

Синтаксис

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

Параметры

hostnames [out]

hostnames содержит имена, которые должны точно соответствовать. Например, если 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