Función DsQuerySitesByCostA (ntdsapi.h)

La función DsQuerySitesByCost obtiene el costo de comunicación entre un sitio y uno o varios otros sitios.

Sintaxis

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

Un identificador de servicio de directorio.

pszFromSite

Puntero a una cadena terminada en NULL que contiene el nombre distintivo relativo del sitio desde el que se miden los costos.

rgszToSites

Contiene una matriz de punteros de cadena terminadas en NULL que contienen los nombres distintivos relativos de los sitios a los que se miden los costos.

[in] cToSites

Contiene el número de elementos de la matriz de rgwszToSites.

[in] dwFlags

Reservado.

[out] prgSiteInfo

Puntero a una matriz de estructuras de DS_SITE_COST_INFO que recibe los datos de costo. Cada elemento de esta matriz contiene los datos de costo entre el sitio identificado por el parámetro pwszFromSite y el sitio identificado por el elemento de correspondiente rgwszToSites.

El autor de la llamada debe liberar esta memoria cuando ya no sea necesaria llamando a DsQuerySitesFree.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un código de error Win32 o RPC en caso contrario. Los códigos de error posibles incluyen valores enumerados en la lista siguiente.

Observaciones

Los valores de costo obtenidos por esta función solo se usan para comparar y no tienen ningún significado por sí mismos. Por ejemplo, el costo del sitio 1 se puede comparar con el costo del sitio 2, pero el costo del sitio 1 no se puede comparar con un valor fijo.

Nota

El encabezado ntdsapi.h define DsQuerySitesByCost como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
de la plataforma de destino de	Windows
encabezado de	ntdsapi.h
biblioteca de	Ntdsapi.lib
DLL de	Ntdsapi.dll

Consulte también

DS_SITE_COST_INFO

controlador de dominio y funciones de administración de replicación

DsQuerySitesFree