Funzione DsQuerySitesByCostA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsQuerySitesByCost ottiene il costo di comunicazione tra un sito e uno o più siti.

Sintassi

NTDSAPI_POSTXP DWORD DsQuerySitesByCostA(
  [in]  HANDLE             hDS,
        LPSTR              pszFromSite,
        LPSTR              *rgszToSites,
  [in]  DWORD              cToSites,
  [in]  DWORD              dwFlags,
  [out] PDS_SITE_COST_INFO *prgSiteInfo
);

Parametri

[in] hDS

Handle del servizio directory.

pszFromSite

Puntatore a una stringa con terminazione Null contenente il nome distinto relativo del sito da cui vengono misurati i costi.

rgszToSites

Contiene una matrice di puntatori stringa con terminazione Null che contengono i nomi distinti relativi dei siti in base ai quali vengono misurati i costi.

[in] cToSites

Contiene il numero di elementi nella matrice rgwszToSites.

[in] dwFlags

Riservato.

[out] prgSiteInfo

Puntatore a una matrice di strutture di DS_SITE_COST_INFO che riceve i dati sui costi. Ogni elemento di questa matrice contiene i dati sui costi tra il sito identificato dal parametro pwszFromSite e il sito identificato dall'elemento rgwszToSites corrispondente.

Il chiamante deve liberare questa memoria quando non è più necessaria chiamando DsQuerySitesFree.

Valore restituito

Restituisce ERROR_SUCCESS se ha esito positivo o un codice di errore Win32 o RPC in caso contrario. I codici di errore possibili includono i valori elencati nell'elenco seguente.

Osservazioni

I valori di costo ottenuti da questa funzione vengono usati solo per confrontare e non avere alcun significato da soli. Ad esempio, il costo per il sito 1 può essere confrontato con il costo per il sito 2, ma il costo per il sito 1 non può essere confrontato con un valore fisso.

Nota

L'intestazione ntdsapi.h definisce DsQuerySitesByCost come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	ntdsapi.h
libreria	Ntdsapi.lib
dll	Ntdsapi.dll

Vedere anche

DS_SITE_COST_INFO

controller di dominio e funzioni di gestione della replica

DsQuerySitesFree

Condividi tramite