Funzione DsListServersInSiteA (ntdsapi.h)

  • Articolo

La funzione DsListServersInSite elenca tutti i server di 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 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 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.

Commenti

Gli errori di conversione dei nomi singoli vengono segnalati nella struttura 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 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

DS_NAME_RESULT

Funzioni di gestione del controller di dominio e della replica

DsFreeNameResult