Funzione DsListDomainsInSiteA (ntdsapi.h)

La funzione DsListDomainsInSite elenca tutti i domini in un sito.

Sintassi

NTDSAPI DWORD DsListDomainsInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppDomains
);

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. Questa stringa viene ricavata dall'elenco dei nomi di sito restituiti dalla funzione DsListSites .

[out] ppDomains

Puntatore a un puntatore a una struttura DS_NAME_RESULT che riceve l'elenco di domini nel sito. Per liberare la struttura restituita, chiamare la funzione DsFreeNameResult .

Valore restituito

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