DsQuerySitesByCostA 関数 (ntdsapi.h)
DsQuerySitesByCost 関数は、1 つのサイトと 1 つ以上の他のサイトとの間の通信コストを取得します。
構文
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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsQuerySitesByCost を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | ntdsapi.h |
| ライブラリ | Ntdsapi.lib |
| DLL | Ntdsapi.dll |