Funzione DsListInfoForServerA (ntdsapi.h)

Articolo
08/25/2023

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