Compartir a través de


Función DsGetDcSiteCoverageA (dsgetdc.h)

La función DsGetDcSiteCoverage devuelve los nombres de sitio de todos los sitios cubiertos por un controlador de dominio.

Sintaxis

DSGETDCAPI DWORD DsGetDcSiteCoverageA(
  [in, optional] LPCSTR ServerName,
  [out]          PULONG EntryCount,
  [out]          LPSTR  **SiteNames
);

Parámetros

[in, optional] ServerName

Valor de cadena terminada en NULL que especifica el nombre del controlador de dominio remoto.

[out] EntryCount

Puntero a un valor de ULONG que recibe el número de sitios cubiertos por el controlador de dominio.

[out] SiteNames

Puntero a una matriz de punteros a cadenas terminadas en null que recibe los nombres de sitio. Para liberar el búfer devuelto, llame a la función netApiBufferFree .

Valor devuelto

Esta función devuelve DSGETDCAPI DWORD.

Observaciones

Nota

El encabezado dsgetdc.h define DsGetDcSiteCoverage 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 dsgetdc.h
biblioteca de Netapi32.lib
DLL de Netapi32.dll

Consulte también

funciones del servicio de directorio de

DsGetSiteName

NetApiBufferFree