Funzione DsListSitesA (ntdsapi.h)
La funzione DsListSites elenca tutti i siti nella foresta aziendale.
Sintassi
NTDSAPI DWORD DsListSitesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *ppSites
);
Parametri
[in] hDs
Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred .
[out] ppSites
Puntatore a un puntatore a una struttura DS_NAME_RESULT che riceve l'elenco di siti nell'organizzazione. Il nome del sito viene restituito nel formato DN (Distinguished Name). La struttura restituita deve essere liberata usando la funzione DsFreeNameResult .
Valore restituito
Se la funzione restituisce un elenco di siti, il valore restituito viene NO_ERROR. Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
Commenti
Gli errori di conversione dei nomi singoli vengono segnalati nella struttura DS_NAME_RESULT restituita.
Nota
L'intestazione ntdsapi.h definisce DsListSites 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 | ntdsapi.h |
| Libreria | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
Vedi anche
Funzioni di gestione del controller di dominio e della replica