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

Weitere Informationen

DS_SITE_COST_INFO

Domänencontroller und Replikationsverwaltungsfunktionen

DsQuerySitesFree