Fungsi GetTenantRestrictionsHostnames

Artikel
06/03/2023

Fungsi GetTenantRestrictionsHostnames mengembalikan daftar hostnames (misalnya foo.ca) dan subdomainSupportedHostnames (misalnya .bar.ca) ke pemanggil. Daftar ini tetap sinkron oleh Windows dan digunakan oleh aplikasi untuk menerapkan Pembatasan Penyewa ke titik akhir tersebut.

Sintaks

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

Parameter

hostnames [out]

nama host berisi nama yang harus sama persis. Misalnya, jika foo.ca ada dalam daftar, maka foo.caharus tunduk pada Pembatasan Penyewa, tetapi bar.foo.catidak boleh.

hostnameCount [out]

Parameter hostnameCount berisi jumlah nama host dalam hostnames array.

subdomainSupportedHostnames [out]

subdomainSupportedHostnames berisi nama yang memungkinkan subdomain, misalnya jika .bar.ca ada dalam daftar, sub.bar.caharus tunduk pada Pembatasan Penyewa tetapi bar.catidak boleh. Entri ini diharapkan memiliki sebelumnya untuk memfasilitasi pencocokan . .

subdomainSupportedHostnameCount [out]

Parameter subdomainSupportedHostnameCount berisi jumlah nama host dalam subdomainSupportedHostnames array.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Keterangan

Penelepon harus secara berulang membebaskan entri array menggunakan CoTaskMemFree dan kemudian membebaskan array itu sendiri.

Mengenai array kosong:

Ini valid (meskipun tidak diharapkan dalam praktiknya) agar kedua daftar kosong.
Ini valid untuk satu daftar untuk memuat entri sementara yang lain tidak.

Dalam kedua kasus, membatalkan alokasi daftar kosong tidak diperlukan. Tidak diperlukan de-alokasi jika nilai yang dikembalikan bukan S_OK.

Fungsi ini tidak mengembalikan nilai keberhasilan selain S_OK.

Fungsi ini tidak memiliki pustaka impor atau file header terkait; Anda harus memanggilnya menggunakan fungsi LoadLibrary dan GetProcAddress .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 2004 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 2004 [hanya aplikasi desktop]
DLL	TenantRestrictionsPlugin.dll

Bagikan melalui