DsAddressToSiteNamesExA, fonction (dsgetdc.h)

Article
11/20/2024

La fonction DsAddressToSiteNamesEx obtient les noms de site et de sous-réseau correspondant aux adresses spécifiées.

Syntaxe

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

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.

[out] SubnetNames

Reçoit un tableau de pointeurs de chaîne terminées par null qui contiennent les noms de sous-réseau utilisés pour effectuer l’adresse aux mappages de noms de site. Chaque élément de ce tableau correspond au même élément du tableau socketAddresses . Un élément est null si l’adresse correspondante au mappage de noms de site n’a pas été déterminée ou si aucun sous-réseau n’a été utilisé pour effectuer l’adresse correspondante au mappage de site. Ce dernier sera le cas lorsqu’il existe exactement un site dans l’entreprise sans aucun objet de sous-réseau mappé à celui-ci. 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. Voici les codes d’erreur possibles.

Remarques

Note

L’en-tête dsgetdc.h définit DsAddressToSiteNamesEx 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

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree

Partager via