DsListInfoForServerA, fonction (ntdsapi.h)

Article
11/20/2024

La fonction DsListInfoForServer répertorie des données diverses pour un serveur.

Syntaxe

NTDSAPI DWORD DsListInfoForServerA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           server,
  [out] PDS_NAME_RESULTA *ppInfo
);

Paramètres

[in] hDs

Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred.

[in] server

Pointeur vers une chaîne terminée par null qui spécifie le nom du serveur. Ce nom doit être identique à l’une des chaînes retournées par la fonction DsListServersForDomainInSite ou fonction d' DsListServersInSite.

[out] ppInfo

Pointeur vers une variable qui reçoit un pointeur vers une structure DS_NAME_RESULT qui contient les données du serveur. La structure retournée doit être libérée à l’aide de DsFreeNameResult.

Les index du tableau dans la structure DS_NAME_RESULT indiquent les données contenues par chaque élément de tableau. Les constantes suivantes peuvent être utilisées pour spécifier l’index souhaité pour un élément de données particulier.

DS_LIST_ACCOUNT_OBJECT_FOR_SERVER

Nom de l’objet de compte pour le contrôleur de domaine (DC).

DS_LIST_DNS_HOST_NAME_FOR_SERVER

Nom d’hôte DNS du contrôleur de domaine.

DS_LIST_DSA_OBJECT_FOR_SERVER

GUID de l’agent de service d’annuaire (DSA) pour le contrôleur de domaine (DC).

Valeur de retour

Si la fonction retourne des données serveur, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Remarques

Les erreurs de conversion de noms individuelles sont signalées dans la structure de DS_NAME_RESULT retournée.

Note

L’en-tête ntdsapi.h définit DsListInfoForServer comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	ntdsapi.h
bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll