Funzione DsQuerySitesByCostA (ntdsapi.h)

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 che contiene il nome distinto relativo del sito, i costi vengono misurati.

rgszToSites

Contiene una matrice di puntatori stringa con terminazione null che contengono i nomi distinti relativi dei siti a cui 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 DS_SITE_COST_INFO che ricevono 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ù richiesto 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.

Commenti

I valori dei costi 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	ntdsapi.h
Libreria	Ntdsapi.lib
DLL	Ntdsapi.dll

Vedi anche

DS_SITE_COST_INFO

Funzioni di gestione del controller di dominio e della replica

DsQuerySitesFree