Funzione DsListSitesA (ntdsapi.h)
La funzione DsListSites
Sintassi
NTDSAPI DWORD DsListSitesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *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 |