Función GetTenantRestrictionsHostnames

  • Artículo

La función GetTenantRestrictionsHostnames devuelve una lista de hostnames (por ejemplo foo.ca, ) y subdomainSupportedHostnames (por ejemplo .bar.ca, ) al autor de la llamada. Windows mantiene sincronizada esta lista y las aplicaciones usan para aplicar restricciones de inquilino a esos puntos de conexión.

Sintaxis

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

Parámetros

hostnames [out]

los nombres de host contienen nombres que deben coincidir exactamente. Por ejemplo, si foo.ca está en la lista, foo.cadebe estar sujeto a restricciones de inquilino, pero bar.foo.cano debe hacerlo.

hostnameCount [out]

El parámetro hostnameCount contiene el número de nombres de host de la hostnames matriz.

subdomainSupportedHostnames [out]

subdomainSupportedHostnames contiene nombres que permiten subdominios, por ejemplo, si .bar.ca está en la lista, deben estar sujetos a restricciones de inquilino, sub.bar.ca pero bar.cano. Se espera que estas entradas tengan un elemento anterior . para facilitar la coincidencia.

subdomainSupportedHostnameCount [out]

El parámetro subdomainSupportedHostnameCount contiene el número de nombres de host de la subdomainSupportedHostnames matriz.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Observaciones

Los autores de las llamadas deben liberar iterativamente entradas de matriz mediante CoTaskMemFree y, a continuación, liberar la propia matriz.

Con respecto a matrices vacías:

  • Es válido (aunque no se espera en la práctica) para que ambas listas estén vacías.
  • Es válido para que una lista contenga entradas, mientras que la otra no.

En cualquier caso, no es necesario anular la asignación de una lista vacía. No se necesita desasignación si el valor devuelto no S_OKes .

La función no devuelve valores correctos distintos de S_OK.

Esta función no tiene ningún archivo de encabezado o biblioteca de importación asociado; Debe llamarlo mediante las funciones LoadLibrary y GetProcAddress .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 2004 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server, versión 2004 [solo aplicaciones de escritorio]
Archivo DLL TenantRestrictionsPlugin.dll