DsQuerySitesByCostA-Funktion (ntdsapi.h)
Die DsQuerySitesByCost-Funktion ruft die Kommunikationskosten zwischen einem Standort und mindestens einem anderen Standort ab.
Syntax
NTDSAPI_POSTXP DWORD DsQuerySitesByCostA(
[in] HANDLE hDS,
LPSTR pszFromSite,
LPSTR *rgszToSites,
[in] DWORD cToSites,
[in] DWORD dwFlags,
[out] PDS_SITE_COST_INFO *prgSiteInfo
);
Parameter
[in] hDS
Ein Verzeichnisdiensthandle.
pszFromSite
Zeiger auf eine null-beendete Zeichenfolge, die den relativen Distinguished-Namen der Website enthält, von der die Kosten gemessen werden.
rgszToSites
Enthält ein Array von NULL-beendeten Zeichenfolgenzeigern, die die relativen Distinguished-Namen der Standorte enthalten, für die die Kosten gemessen werden.
[in] cToSites
Enthält die Anzahl der Elemente im rgwszToSites-Array .
[in] dwFlags
Reserviert.
[out] prgSiteInfo
Zeiger auf ein Array von DS_SITE_COST_INFO Strukturen, das die Kostendaten empfängt. Jedes Element in diesem Array enthält die Kostendaten zwischen der durch den pwszFromSite-Parameter identifizierten Website und der durch das entsprechende rgwszToSites-Element identifizierten Website.
Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem Er DsQuerySitesFree aufruft.
Rückgabewert
Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder andernfalls ein Win32- oder RPC-Fehlercode. Mögliche Fehlercodes umfassen Werte, die in der folgenden Liste aufgeführt sind.
Hinweise
Die von dieser Funktion erhaltenen Kostenwerte werden nur zum Vergleichen verwendet und haben für sich genommen keine Bedeutung. Beispielsweise können die Kosten für Standort 1 mit den Kosten für Standort 2 verglichen werden, aber die Kosten für Standort 1 können nicht mit einem festen Wert verglichen werden.
Hinweis
Der ntdsapi.h-Header definiert DsQuerySitesByCost als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | ntdsapi.h |
| Bibliothek | Ntdsapi.lib |
| DLL | Ntdsapi.dll |