Funzione DsGetDcSiteCoverageA (dsgetdc.h)

La funzione DsGetDcSiteCoverage restituisce i nomi dei siti di tutti i siti coperti da un controller di dominio.

Sintassi

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

Parametri

[in, optional] ServerName

Valore stringa con terminazione Null che specifica il nome del controller di dominio remoto.

[out] EntryCount

Puntatore a un valore ULONG che riceve il numero di siti coperti dal controller di dominio.

[out] SiteNames

Puntatore a una matrice di puntatori a stringhe con terminazione Null che riceve i nomi del sito. Per liberare il buffer restituito, chiamare la funzione NetApiBufferFree .

Valore restituito

Questa funzione restituisce DSGETDCAPI DWORD.

Commenti

Nota

L'intestazione dsgetdc.h definisce DsGetDcSiteCoverage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsgetdc.h
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

Funzioni del servizio directory

DsGetSiteName

NetApiBufferFree