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 dalla funzione DsListDomainsInSite .

[in] site

Puntatore a una stringa con terminazione null che specifica il nome del sito. Questa stringa viene presa dall'elenco dei nomi del sito 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.

Commenti

Gli errori di conversione dei nomi singoli vengono segnalati nella struttura 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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

DS_NAME_RESULT

Funzioni di gestione del controller di dominio e della replica

DsFreeNameResult