Função DsQuerySitesByCostA (ntdsapi.h)

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

Sintaxe

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

Parâmetros

[in] hDS

Um identificador de serviço de diretório.

pszFromSite

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

rgszToSites

Contém uma matriz de ponteiros de cadeia de caracteres terminadas em 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 rgwszToSites correspondente.

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

Retornar valor

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.

Comentários

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 com o custo do site 2, mas o custo do site 1 não pode ser comparado a um valor fixo.

Observação

O cabeçalho ntdsapi.h define DsQuerySitesByCost como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	ntdsapi.h
Biblioteca	Ntdsapi.lib
DLL	Ntdsapi.dll

Confira também

DS_SITE_COST_INFO

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

DsQuerySitesFree