Share via

macro NetAddr_GetAddress (shellapi.h)

  • Article

Indique si une adresse réseau est conforme à un type et un format spécifiés.

Syntaxe

void NetAddr_GetAddress(
             hwnd,
  [in, out]  pv
);

Paramètres

hwnd

Handle du contrôle d’adresse réseau qui contient l’adresse à valider.

[in, out] pv

Pointeur vers une structure de NC_ADDRESS pour recevoir les informations d’adresse réseau sous forme analysée, si le format d’adresse et le type dans le contrôle spécifié par hwnd sont validés. L’application appelante est chargée d’allouer la mémoire pour cette structure.

Valeur de retour

None

Remarques

Utilisez la macro NetAddr_GetAddress pour valider une adresse réseau dans un contrôle d’adresse réseau par rapport à un masque de type d’adresse réseau prédéfini. Pour instancier, utilisez la classe msctls_netaddress définie dans Shellapi.h. Appelez InitNetworkAddressControl au moment de l’exécution avant d’appeler cette macro. Cette opération initialise la bibliothèque de contrôles communs qui contient le contrôle d’adresse réseau.

Cette macro obtient la chaîne d’adresse réseau à partir d’un contrôle d’adresse réseau, analyse la chaîne et vérifie si la chaîne correspond à un masque de type d’adresse réseau. Si la chaîne correspond au masque, la fonction retourne S_OK et retourne la chaîne sous forme analysée à l’application appelante (y compris le numéro de port, la longueur du préfixe et d’autres informations d’adresse), à l’aide de la structure NC_ADDRESS pointée par pv. Cette macro retourne E_INVALIDARG si l’application appelante ne parvient pas à allouer la structure pointée par pv.

Les représentations d’adresses IP (Internet Protocol) versions 4 et 6 (v4/v6) pour les services et réseaux, ainsi que les adresses Internet et services nommés utilisant le format DNS (Domain Name System) sont analysées. Si la chaîne d’adresse réseau représente un nom d’hôte (DNS) ou un service nommé, la valeur retournée dans le membre PrefixLength de NC_ADDRESS est égale à zéro.

Définissez le masque de type d’adresse réseau à l’aide de la macro NetAddr_SetAllowType avant d’appeler la macro NetAddr_GetAddress .

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shellapi.h

Voir aussi

NetAddr_GetAllowType