Share via

GetTenantRestrictionsHostnames-Funktion

  • Artikel

Die GetTenantRestrictionsHostnames-Funktion gibt eine Liste von hostnames (z. B. foo.ca) und subdomainSupportedHostnames (z. B. .bar.ca) an den Aufrufer zurück. Diese Liste wird von Windows synchronisiert und von Apps verwendet, um Mandanteneinschränkungen auf diese Endpunkte anzuwenden.

Syntax

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

Parameter

hostnames [out]

hostnames enthält Namen, die genau übereinstimmen müssen. Wenn foo.ca z. B. in der Liste enthalten ist, sollte den foo.ca Mandanteneinschränkungen unterliegen, aberbar.foo.ca nicht.

hostnameCount [out]

Der hostnameCount-Parameter enthält die Anzahl der Hostnamen im hostnames Array.

subdomainSupportedHostnames [out]

subdomainSupportedHostnames enthält Namen, die Unterdomänen zulassen, z. B. wenn .bar.ca in der Liste enthalten ist, sub.bar.ca den Mandanteneinschränkungen unterliegen, aber bar.canicht. Es wird erwartet, dass diese Einträge über einen vorangehenden . verfügen, um den Abgleich zu erleichtern.

subdomainSupportedHostnameCount [out]

Der Parameter subdomainSupportedHostnameCount enthält die Anzahl der Hostnamen im subdomainSupportedHostnames Array.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion zurück S_OK.

Bemerkungen

Aufrufer sollten Arrayeinträge mithilfe von CoTaskMemFree iterativ freigeben und dann das Array selbst freigeben.

Bei leeren Arrays:

  • Es ist gültig (obwohl in der Praxis nicht erwartet), dass beide Listen leer sind.
  • Es ist gültig, dass eine Liste Einträge enthält, während die andere nicht.

In beiden Fällen ist das Aufheben der Zuweisung einer leeren Liste nicht erforderlich. Es ist keine Aufhebung der Zuordnung erforderlich, wenn der Rückgabewert nicht S_OKist.

Die Funktion gibt keine anderen Erfolgswerte als S_OKzurück.

Dieser Funktion ist keine Importbibliothek oder Headerdatei zugeordnet. Sie müssen sie mit den Funktionen LoadLibrary und GetProcAddress aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server, Version 2004 [nur Desktop-Apps]
DLL TenantRestrictionsPlugin.dll