DsAddressToSiteNamesW, fonction (dsgetdc.h)
La fonction DsAddressToSiteNames obtient les noms de site correspondant aux adresses spécifiées.
Syntaxe
DSGETDCAPI DWORD DsAddressToSiteNamesW(
[in, optional] LPCWSTR ComputerName,
[in] DWORD EntryCount,
[in] PSOCKET_ADDRESS SocketAddresses,
[out] LPWSTR **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
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 |