GetTenantRestrictionsHostnames, fonction

Article
06/03/2023

La fonction GetTenantRestrictionsHostnames retourne une liste de hostnames (par exemple foo.ca) et subdomainSupportedHostnames (par exemple .bar.ca) à l’appelant. Cette liste est synchronisée par Windows et est utilisée par les applications pour appliquer des restrictions de locataire à ces points de terminaison.

Syntaxe

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

Paramètres

hostnames [out]

les noms d’hôte contiennent des noms qui doivent correspondre exactement. Par exemple, si foo.ca figure dans la liste, foo.cadoit être soumis aux restrictions de locataire, mais bar.foo.capas.

hostnameCount [out]

Le paramètre hostnameCount contient le nombre de noms d’hôte dans le hostnames tableau.

subdomainSupportedHostnames [out]

subdomainSupportedHostnames contient des noms qui autorisent les sous-domaines, par exemple, si .bar.ca est dans la liste, doit être soumis à des restrictions de locataire, sub.bar.ca mais bar.capas. Ces entrées sont censées avoir un précédent . pour faciliter la mise en correspondance.

subdomainSupportedHostnameCount [out]

Le paramètre subdomainSupportedHostnameCount contient le nombre de noms d’hôte dans le subdomainSupportedHostnames tableau.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Remarques

Les appelants doivent libérer de façon itérative les entrées de tableau à l’aide de CoTaskMemFree , puis libérer le tableau lui-même.

Concernant les tableaux vides :

Il est valide (mais pas attendu dans la pratique) que les deux listes soient vides.
Il est valide qu’une liste contienne des entrées, contrairement à l’autre.

Dans les deux cas, la désaffectation d’une liste vide n’est pas nécessaire. Aucune désallocation n’est nécessaire si la valeur de retour n’est pas S_OK.

La fonction ne retourne pas de valeurs de réussite autres que S_OK.

Cette fonction n’a pas de bibliothèque d’importation ou de fichier d’en-tête associé ; vous devez l’appeler à l’aide des fonctions LoadLibrary et GetProcAddress .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 2004 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 2004 [applications de bureau uniquement]
DLL	TenantRestrictionsPlugin.dll

Partager via