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에는 하위 도메인을 허용하는 이름이 포함되어 있습니다. 예를 들어 목록에 sub.bar.ca 있는 경우 .bar.ca 테넌트 제한 사항이 적용되어야 하지만bar.ca그렇지 않아야 합니다. 이러한 항목은 일치를 용이하게 하기 위해 앞에 . 있을 것으로 예상됩니다.

subdomainSupportedHostnameCount [out]

subdomainSupportedHostnameCount 매개 변수에는 배열의 호스트 이름 subdomainSupportedHostnames 수가 포함됩니다.

반환 값

함수가 성공하면 함수는 를 반환합니다 S_OK.

설명

호출자는 CoTaskMemFree 를 사용하여 배열 항목을 반복적으로 해제한 다음 배열 자체를 해제해야 합니다.

빈 배열 관련:

• 두 목록이 모두 비어 있는 것은 유효합니다(실제로는 예상되지 않지만).
• 한 목록에는 항목이 포함되어 있지만 다른 목록에는 포함되지 않는 것이 유효합니다.

두 경우 모두 빈 목록을 할당 해제할 필요가 없습니다. 반환 값이 이 아닌 경우 할당 해제가 필요하지 않습니다 S_OK.

함수는 이외의 S_OK성공 값을 반환하지 않습니다.

이 함수에는 연결된 가져오기 라이브러리 또는 헤더 파일이 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 2004 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server, 버전 2004 [데스크톱 앱만 해당]
DLL	TenantRestrictionsPlugin.dll