Funzione DsListSitesW (ntdsapi.h)

La funzione DsListSites elenca tutti i siti nella foresta aziendale.

Sintassi

NTDSAPI DWORD DsListSitesW(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTW *ppSites
);

Parametri

[in] hDs

Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.

[out] ppSites

Puntatore a un puntatore a una struttura DS_NAME_RESULT che riceve l'elenco dei siti nell'organizzazione. Il nome del sito viene restituito nel formato DN (Distinguished Name). La struttura restituita deve essere liberata usando la funzione DsFreeNameResult .

Valore restituito

Se la funzione restituisce un elenco di siti, 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 DsListSites 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

Vedere anche

DS_NAME_RESULT

controller di dominio e funzioni di gestione della replica

DsFreeNameResult