Funzione DsListServersInSiteA (ntdsapi.h)
La funzione DsListServersInSite elenca tutti i server in un sito.
Sintassi
NTDSAPI DWORD DsListServersInSiteA(
[in] HANDLE hDs,
[in] LPCSTR site,
[out] PDS_NAME_RESULTA *ppServers
);
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. Il nome del sito usa un formato di nome distinto. Viene ricavato dall'elenco di siti restituiti dalla funzione DsListSites
[out] ppServers
Puntatore a un puntatore a una struttura DS_NAME_RESULT che riceve l'elenco dei server nel sito. 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 DsListServersInSite 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 |