Função GetTenantRestrictionsHostnames

A função GetTenantRestrictionsHostnames retorna uma lista de hostnames (por exemplo foo.ca, ) e subdomainSupportedHostnames (por exemplo, .bar.ca) para o chamador. Essa lista é mantida em sincronia pelo Windows e é usada por aplicativos para aplicar restrições de locatário a esses pontos de extremidade.

Sintaxe

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

Parâmetros

hostnames [out]

hostnames contém nomes que devem corresponder exatamente. Por exemplo, se foo.ca estiver na lista, deveráfoo.ca estar sujeito a Restrições de Locatário, mas bar.foo.canão deve.

hostnameCount [out]

O parâmetro hostnameCount contém o número de nomes de host na hostnames matriz.

subdomainSupportedHostnames [out]

subdomainSupportedHostnames contém nomes que permitem subdomínios, por exemplo, se .bar.ca estiver na lista, sub.bar.cadevem estar sujeitos a Restrições de Locatário, mas bar.canão devem. Espera-se que essas entradas tenham um precedente . para facilitar a correspondência.

subdomainSupportedHostnameCount [out]

O parâmetro subdomainSupportedHostnameCount contém o número de nomes de host na subdomainSupportedHostnames matriz.

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Comentários

Os chamadores devem liberar iterativamente entradas de matriz usando CoTaskMemFree e liberar a própria matriz.

Em relação a matrizes vazias:

• É válido (embora não seja esperado na prática) que ambas as listas estejam vazias.
• É válido que uma lista contenha entradas, enquanto a outra não.

Em ambos os casos, a desalocação de uma lista vazia não é necessária. Nenhuma desopção será necessária se o valor retornado não S_OKfor .

A função não retorna valores de êxito diferentes de S_OK.

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .

Requisitos