GetTenantRestrictionsHostnames, fonction
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.ca
doit être soumis aux restrictions de locataire, mais bar.foo.ca
pas.
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.ca
pas. 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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour