NCM_GETADDRESS message

Article
06/13/2023

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

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;

Paramètres

wParam: Doit être zéro.
pv [in, out]: 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 responsable de l’allocation de la mémoire pour cette structure.

Valeur retournée

Retourne l’une des valeurs suivantes de type HRESULT.

Code de retour	Description
E_INVALIDARG	L’application appelante n’a pas pu allouer une structure NC_ADDRESS .
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon de sortie est trop petite pour contenir l’adresse réseau analysée.
ERROR_INVALID_PARAMETER	La chaîne d’adresse réseau n’est d’aucun type spécifié.
ERROR_SUCCESS	L'opération a réussi.
S_FALSE	Il n’existe aucune adresse dans le contrôle d’adresse réseau à valider.

Notes

Utilisez le message NCM_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’envoyer ce message. Cela initialise la bibliothèque de contrôles courants qui contient le contrôle d’adresse réseau.

Ce message 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, le message 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 vers pv. Ce message retourne E_INVALIDARG si l’application appelante ne parvient pas à allouer la structure pointée vers pv.

Les représentations des 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 au format DNS (Domain Name System) sont analysés. Si la chaîne d’adresse réseau représente un nom d’hôte (DNS) ou un service nommé, la valeur renvoyée dans le membre PrefixLength de NC_ADDRESS est égale à zéro.

Définissez le masque de type d’adresse réseau à l’aide du message NCM_SETALLOWTYPE avant d’envoyer la macro NCM_GETADDRESS .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Shellapi.h

Voir aussi

NCM_GETALLOWTYPE
NetAddr_GetAddress

Partager via