DsAddressToSiteNamesExW, fonction (dsgetdc.h)

  • Article

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

Syntaxe

DSGETDCAPI DWORD DsAddressToSiteNamesExW(
  [in, optional] LPCWSTR         ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPWSTR          **SiteNames,
  [out]          LPWSTR          **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-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 du type AF_INET. EntryCount contient le nombre d’éléments dans ce tableau.

[out] SiteNames

Reçoit un tableau de pointeurs de chaîne terminés par null qui contiennent les noms de site pour les adresses. Chaque élément de ce tableau correspond au même élément dans le tableau SocketAddresses . Un élément a la valeur NULL si l’adresse correspondante ne correspond à aucun site connu ou si l’entrée d’adresse n’est pas de la forme appropriée. L’appelant doit libérer ce tableau quand il n’est plus nécessaire en appelant NetApiBufferFree.

[out] SubnetNames

Reçoit un tableau de pointeurs de chaîne terminés par null qui contiennent les noms de sous-réseau utilisés pour effectuer les mappages de nom d’adresse à site. Chaque élément de ce tableau correspond au même élément dans le tableau SocketAddresses . Un élément a la valeur NULL si le mappage d’adresse à nom de site correspondant n’a pas été déterminé ou si aucun sous-réseau n’a été utilisé pour effectuer le mappage d’adresse à site correspondant. Ce dernier sera le cas lorsqu’il y a exactement un site dans l’entreprise sans objet de sous-réseau mappé. L’appelant doit libérer ce tableau quand il n’est plus nécessaire en appelant NetApiBufferFree.

Valeur retournée

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

Notes

Notes

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

Spécifications

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête dsgetdc.h
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

Fonctions de service d’annuaire

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree