Funzione DsListInfoForServerA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsListInfoForServer elenca i dati esterni 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 corrispondere 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 che contiene 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. È possibile utilizzare le costanti seguenti 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.

Osservazioni

Gli errori di conversione dei nomi singoli vengono segnalati nella struttura di 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 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