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.

Comentarios

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 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	dsgetdc.h
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

Funciones del servicio de directorio

DsGetSiteName

NetApiBufferFree