DsQuerySitesByCostW 함수(ntdsapi.h)

DsQuerySitesByCost 함수는 한 사이트와 하나 이상의 다른 사이트 간의 통신 비용을 가져옵니다.

통사론

NTDSAPI_POSTXP DWORD DsQuerySitesByCostW(
  [in]  HANDLE             hDS,
  [in]  LPWSTR             pwszFromSite,
  [in]  LPWSTR             *rgwszToSites,
  [in]  DWORD              cToSites,
  [in]  DWORD              dwFlags,
  [out] PDS_SITE_COST_INFO *prgSiteInfo
);

매개 변수

[in] hDS

디렉터리 서비스 핸들입니다.

[in] pwszFromSite

비용이 측정되는 사이트의 상대적 고유 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] rgwszToSites

비용이 측정되는 사이트의 상대적인 고유 이름을 포함하는 null로 끝나는 문자열 포인터의 배열을 포함합니다.

[in] cToSites

rgwszToSites 배열의 요소 수를 포함합니다.

[in] dwFlags

예약.

[out] prgSiteInfo

비용 데이터를 수신하는 DS_SITE_COST_INFO 구조의 배열에 대한 포인터입니다. 이 배열의 각 요소에는 pwszFromSite 매개 변수로 식별된 사이트와 해당 rgwszToSites 요소로 식별된 사이트 간의 비용 데이터가 포함됩니다.

호출자는 DsQuerySitesFree호출하여 더 이상 필요하지 않은 경우 이 메모리를 해제해야 합니다.

반환 값

성공하면 ERROR_SUCCESS 반환하고, 그렇지 않으면 Win32 또는 RPC 오류 코드를 반환합니다. 가능한 오류 코드에는 다음 목록에 나열된 값이 포함됩니다.

발언

이 함수에서 얻은 비용 값은 비교하는 데만 사용되며 그 자체로는 의미가 없습니다. 예를 들어 사이트 1의 비용을 사이트 2의 비용과 비교할 수 있지만 사이트 1의 비용은 고정 값과 비교할 수 없습니다.

메모

ntdsapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsQuerySitesByCost를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	ntdsapi.h
라이브러리	Ntdsapi.lib
DLL	Ntdsapi.dll