DsQuerySitesByCostA-Funktion (ntdsapi.h)

Artikel
11/20/2024

Die DsQuerySitesByCost Funktion ruft die Kommunikationskosten zwischen einer Website und einem oder mehreren anderen Websites 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 mit Null beendete Zeichenfolge, die den relativen distinguishierten Namen der Website enthält, von der die Kosten gemessen werden.

rgszToSites

Enthält ein Array mit null-beendeten Zeichenfolgenzeigern, die die relativen Distinguished Names der Websites enthalten, an denen die Kosten gemessen werden.

[in] cToSites

Enthält die Anzahl der Elemente im rgwszToSites Array.

[in] dwFlags

Reserviert.

[out] prgSiteInfo

Zeigen Sie auf ein Array von DS_SITE_COST_INFO Strukturen, die die Kostendaten empfangen. Jedes Element in diesem Array enthält die Kostendaten zwischen dem Standort, der durch den parameter pwszFromSite und der durch das entsprechende rgwszToSites Element identifizierten Website identifiziert wird.

Der Aufrufer muss diesen Speicher freigeben, wenn er nicht mehr benötigt wird, indem DsQuerySitesFree-aufgerufen wird.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn der Fehlercode Win32 oder RPC erfolgreich war. Mögliche Fehlercodes sind Werte, die in der folgenden Liste aufgeführt sind.

Bemerkungen

Die von dieser Funktion erhaltenen Kostenwerte werden nur verwendet, um sie zu vergleichen und selbst keine Bedeutung zu haben. Die Kosten für Standort 1 können beispielsweise mit den Kosten für Standort 2 verglichen werden, die Kosten für Standort 1 können jedoch nicht mit einem festen Wert verglichen werden.

Anmerkung

Der ntdsapi.h-Header definiert DsQuerySitesByCost als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows Vista
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	ntdsapi.h
Library	Ntdsapi.lib
DLL-	Ntdsapi.dll

Siehe auch

DS_SITE_COST_INFO

Domänencontroller- und Replikationsverwaltungsfunktionen

DsQuerySitesFree-

Freigeben über