Fonction DsListInfoForServerA (ntdsapi.h)

Article
02/29/2024

La fonction DsListInfoForServer répertorie les données diverses d’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 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 dans chaque élément du 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 retournée

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 DS_NAME_RESULT retournée.

Notes

L’en-tête ntdsapi.h définit DsListInfoForServer comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	ntdsapi.h
Bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll