次の方法で共有

GetTenantRestrictionsHostnames 関数

  • [アーティクル]

GetTenantRestrictionsHostnames 関数は、 (例: ) と subdomainSupportedHostnames (例: foo.ca.bar.ca) のhostnamesリストを呼び出し元に返します。 この一覧は Windows によって同期され、これらのエンドポイントに テナント制限 を適用するためにアプリによって使用されます。

構文

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

パラメーター

hostnames [out]

hostnames には、 正確に一致する必要がある名前が含まれています。 たとえば、 が一覧に含まれている場合foo.caは、foo.caテナント制限の対象になりますがbar.foo.ca、適用しないでください。

hostnameCount [out]

hostnameCount パラメーターには、配列内のホスト名の数がhostnames含まれています。

subdomainSupportedHostnames [out]

subdomainSupportedHostnames には、サブドメインを許可する名前が含まれています。たとえば、 が一覧に含まれている場合.bar.caは、テナント制限の対象にする必要がありますがbar.ca、sub.bar.ca許可しないでください。 これらのエントリには、照合を容易にするために、 が先行している . 必要があります。

subdomainSupportedHostnameCount [out]

subdomainSupportedHostnameCount パラメーターには、配列内のホスト名の数がsubdomainSupportedHostnames含まれています。

戻り値

関数が成功した場合、関数は を返します S_OK。

注釈

呼び出し元は 、CoTaskMemFree を使用して配列エントリを反復的に解放してから、配列自体を解放する必要があります。

空の配列について:

  • 両方のリストが空であることが有効です (実際には想定されていません)。
  • 一方のリストにはエントリが含まれるのに対し、もう一方のリストにはエントリが含まれない場合は有効です。

いずれの場合も、空のリストの割り当てを解除する必要はありません。 戻り値が でない場合、割り当て解除は必要ありません S_OK。

関数は、 以外 S_OKの成功値を返しません。

この関数には、インポート ライブラリまたはヘッダー ファイルが関連付けされません。 LoadLibrary 関数と GetProcAddress 関数を使用して呼び出す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 10バージョン 2004 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server バージョン 2004 [デスクトップ アプリのみ]
[DLL] TenantRestrictionsPlugin.dll