Funzione DsListDomainsInSiteA (ntdsapi.h)
La funzione
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 dei siti 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.
Osservazioni
Gli errori di conversione dei nomi singoli vengono segnalati nella struttura di 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
ntdsapi.h |
| libreria |
Ntdsapi.lib |
| dll | Ntdsapi.dll |