Funzione DsListDomainsInSiteA (ntdsapi.h)
La funzione DsListDomainsInSite elenca tutti i domini in un sito.
Sintassi
NTDSAPI DWORD DsListDomainsInSiteA(
[in] HANDLE hDs,
[in] LPCSTR site,
[out] PDS_NAME_RESULTA *ppDomains
);
Parametri
[in] hDs
Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred .
[in] site
Puntatore a una stringa con terminazione Null che specifica il nome del sito. Questa stringa viene ricavata dall'elenco dei nomi di sito restituiti dalla funzione DsListSites .
[out] ppDomains
Puntatore a un puntatore a una struttura DS_NAME_RESULT che riceve l'elenco di domini nel sito. Per liberare la struttura restituita, chiamare la funzione DsFreeNameResult .
Valore restituito
Se la funzione restituisce un elenco di domini, il valore restituito è 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 DsListDomainsInSite 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