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 del 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 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 rgwszToSites correspondiente.

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

Valor devuelto

Devuelve ERROR_SUCCESS si el código de error win32 o RPC es correcto. Los códigos de error posibles incluyen valores enumerados en la lista siguiente.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	ntdsapi.h
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll

Consulte también

DS_SITE_COST_INFO

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

DsQuerySitesFree