Funzione DsListServersForDomainInSiteA (ntdsapi.h)
La funzione DsListServersForDomainInSite elenca tutti i server in un dominio in un sito.
Sintassi
NTDSAPI DWORD DsListServersForDomainInSiteA(
[in] HANDLE hDs,
[in] LPCSTR domain,
[in] LPCSTR site,
[out] PDS_NAME_RESULTA *ppServers
);
Parametri
[in] hDs
Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.
[in] domain
Puntatore a una stringa con terminazione Null che specifica il nome di dominio. Questa stringa deve essere uguale a una delle stringhe restituite da funzione DsListDomainsInSite.
[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] ppServers
Puntatore a un puntatore a una struttura DS_NAME_RESULT che riceve l'elenco di server nel dominio. La struttura restituita deve essere liberata usando la funzione DsFreeNameResult
Valore restituito
Se la funzione restituisce un elenco di server, 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 DsListServersForDomainInSite 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 |