DsQuerySitesByCostA 함수(ntdsapi.h)
DsQuerySitesByCost 함수는 한 사이트와 하나 이상의 다른 사이트 간의 통신 비용을 가져옵니다.
통사론
NTDSAPI_POSTXP DWORD DsQuerySitesByCostA(
[in] HANDLE hDS,
LPSTR pszFromSite,
LPSTR *rgszToSites,
[in] DWORD cToSites,
[in] DWORD dwFlags,
[out] PDS_SITE_COST_INFO *prgSiteInfo
);
매개 변수
[in] hDS
디렉터리 서비스 핸들입니다.
pszFromSite
비용이 측정되는 사이트의 상대적 고유 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
rgszToSites
비용이 측정되는 사이트의 상대적인 고유 이름을 포함하는 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 |