Funzione DsListInfoForServerA (ntdsapi.h)
La funzione DsListInfoForServer elenca i dati vari per un server.
Sintassi
NTDSAPI DWORD DsListInfoForServerA(
[in] HANDLE hDs,
[in] LPCSTR server,
[out] PDS_NAME_RESULTA *ppInfo
);
Parametri
[in] hDs
Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.
[in] server
Puntatore a una stringa con terminazione null che specifica il nome del server. Questo nome deve essere uguale a una delle stringhe restituite dalla funzione DsListServersForDomainInSite o DsListServersInSite .
[out] ppInfo
Puntatore a una variabile che riceve un puntatore a una struttura DS_NAME_RESULT contenente i dati del server. La struttura restituita deve essere deallocata usando DsFreeNameResult.
Gli indici della matrice nella struttura DS_NAME_RESULT indicano quali dati sono contenuti da ogni elemento della matrice. Le costanti seguenti possono essere usate per specificare l'indice desiderato per una determinata parte di dati.
DS_LIST_ACCOUNT_OBJECT_FOR_SERVER
Nome dell'oggetto account per il controller di dominio (DC).
DS_LIST_DNS_HOST_NAME_FOR_SERVER
Nome host DNS del controller di dominio.
DS_LIST_DSA_OBJECT_FOR_SERVER
GUID dell'agente del servizio directory (DSA) per il controller di dominio (DC).
Valore restituito
Se la funzione restituisce i dati del 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 DsListInfoForServer 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
Funzioni di gestione del controller di dominio e della replica