Função DsQuerySitesByCostW (ntdsapi.h)

A função DsQuerySitesByCost obtém o custo de comunicação entre um site e um ou mais outros sites.

Sintaxe

NTDSAPI_POSTXP DWORD DsQuerySitesByCostW(
  [in]  HANDLE             hDS,
  [in]  LPWSTR             pwszFromSite,
  [in]  LPWSTR             *rgwszToSites,
  [in]  DWORD              cToSites,
  [in]  DWORD              dwFlags,
  [out] PDS_SITE_COST_INFO *prgSiteInfo
);

Parâmetros

[in] hDS

Um identificador de serviço de diretório.

[in] pwszFromSite

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome relativo diferenciado do site do qual os custos são medidos.

[in] rgwszToSites

Contém uma matriz de ponteiros de cadeia de caracteres com término nulo que contêm os nomes distintos relativos dos sites aos quais os custos são medidos.

[in] cToSites

Contém o número de elementos na matriz rgwszToSites .

[in] dwFlags

Reservado.

[out] prgSiteInfo

Ponteiro para uma matriz de estruturas de DS_SITE_COST_INFO que recebe os dados de custo. Cada elemento nessa matriz contém os dados de custo entre o site identificado pelo parâmetro pwszFromSite e o site identificado pelo elemento de rgwszToSites correspondente.

O chamador deve liberar essa memória quando ela não for mais necessária chamando DsQuerySitesFree.

Valor de retorno

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro Win32 ou RPC, caso contrário. Os códigos de erro possíveis incluem valores listados na lista a seguir.

Observações

Os valores de custo obtidos por essa função são usados apenas para comparar e não têm nenhum significado por si só. Por exemplo, o custo do site 1 pode ser comparado ao custo do site 2, mas o custo do site 1 não pode ser comparado a um valor fixo.

Requisitos

Consulte também

DS_SITE_COST_INFO

Funções de gerenciamento de replicação e controlador de domínio

DsQuerySitesFree