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