Funzione GetTenantRestrictionsHostnames

Articolo
06/03/2023

La funzione GetTenantRestrictionsHostnames restituisce un elenco di hostnames (ad esempio) e subdomainSupportedHostnames (ad foo.caesempio.bar.ca) al chiamante. Questo elenco viene mantenuto sincronizzato da Windows e viene usato dalle app per applicare restrizioni del tenant a tali endpoint.

Sintassi

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

Parametri

hostnames [out]

i nomi host contengono nomi che devono corrispondere esattamente. Ad esempio, se foo.ca è presente nell'elenco, foo.cadeve essere soggetto a Restrizioni del tenant, ma bar.foo.canon deve essere.

hostnameCount [out]

Il parametro hostnameCount contiene il numero di nomi host nella hostnames matrice.

subdomainSupportedHostnames [out]

sottodominioSupportedHostnames contiene nomi che consentono sottodomini, ad esempio se .bar.ca si trova nell'elenco, sub.bar.cadevono essere soggetti a Restrizioni del tenant, ma bar.canon dovrebbero. Queste voci devono avere un precedente . per facilitare la corrispondenza.

subdomainSupportedHostnameCount [out]

Il sottodominioSupportedHostnameCount contiene il numero di nomi host nella subdomainSupportedHostnames matrice.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Commenti

I chiamanti devono liberare in modo iterativo le voci della matrice usando CoTaskMemFree e quindi liberare la matrice stessa.

Per quanto riguarda le matrici vuote:

È valido (anche se non previsto in pratica) affinché entrambi gli elenchi siano vuoti.
È valido per un elenco che contenga voci mentre l'altra non lo è.

In entrambi i casi, l'allocazione di un elenco vuoto non è necessaria. Se il valore restituito non S_OKè .

La funzione non restituisce valori di operazione riuscita diversi da S_OK.

Questa funzione non ha una libreria di importazione o un file di intestazione associato; è necessario chiamarlo usando le funzioni LoadLibrary e GetProcAddress .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 2004 [solo app desktop]
Server minimo supportato	Windows Server, versione 2004 [solo app desktop]
DLL	TenantRestrictionsPlugin.dll

Condividi tramite