DsAddressToSiteNamesA, fonction (dsgetdc.h)

Article
11/20/2024

La fonction DsAddressToSiteNames obtient les noms de site correspondant aux adresses spécifiées.

Syntaxe

DSGETDCAPI DWORD DsAddressToSiteNamesA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames
);

Paramètres

[in, optional] ComputerName

Pointeur vers une chaîne terminée par null qui spécifie le nom du serveur distant pour traiter cette fonction. Ce paramètre doit être le nom d’un contrôleur de domaine. Un contrôleur de domaine non-domaine peut appeler cette fonction en appelant DsGetDcName pour rechercher le contrôleur de domaine.

[in] EntryCount

Contient le nombre d’éléments dans le tableau SocketAddresses.

[in] SocketAddresses

Contient un tableau de structures SOCKET_ADDRESS qui contiennent les adresses à convertir. Chaque adresse de ce tableau doit être de type AF_INET. EntryCount contient le nombre d’éléments de ce tableau.

[out] SiteNames

Reçoit un tableau de pointeurs de chaîne null qui contiennent les noms de site des adresses. Chaque élément de ce tableau correspond au même élément du tableau socketAddresses . Un élément est NULL si l’adresse correspondante ne correspond à aucun site connu ou si l’entrée d’adresse n’est pas du formulaire approprié. L’appelant doit libérer ce tableau lorsqu’il n’est plus nécessaire en appelant NetApiBufferFree.

Valeur de retour

Retourne NO_ERROR en cas de réussite ou d’une erreur Win32 ou RPC dans le cas contraire. La liste suivante répertorie les codes d’erreur possibles.

Remarques

Note

L’en-tête dsgetdc.h définit DsAddressToSiteNames 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	dsgetdc.h
bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

fonctions de service d’annuaire

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree

Partager via