Função DsQuerySitesByCostA (ntdsapi.h)

Artigo
11/20/2024

A função DsQuerySitesByCost obtém o custo de comunicação entre um site e um ou mais outros 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 relativo diferenciado do site do qual os custos são medidos.

rgszToSites

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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	ntdsapi.h
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

DS_SITE_COST_INFO

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

DsQuerySitesFree

Compartilhar via