macro NetAddr_GetAddress (shellapi.h)
Indica si una dirección de red se ajusta a un tipo y formato especificados.
Sintaxis
void NetAddr_GetAddress(
hwnd,
[in, out] pv
);
Parámetros
hwnd
Identificador del control de direcciones de red que contiene la dirección que se va a validar.
[in, out] pv
Puntero a una estructura de NC_ADDRESS para recibir información de dirección de red en formato analizado, si se valida el formato de dirección y el tipo en el control especificado por hwnd . La aplicación que realiza la llamada es responsable de asignar la memoria para esta estructura.
Valor devuelto
None
Observaciones
Use la macro NetAddr_GetAddress para validar una dirección de red en un control de direcciones de red con una máscara de tipo de dirección de red preestablecida. Para crear instancias, use la clase msctls_netaddress definida en Shellapi.h. Llame a InitNetworkAddressControl en tiempo de ejecución antes de llamar a esta macro. Esto inicializa la biblioteca de controles comunes que contiene el control de direcciones de red.
Esta macro obtiene la cadena de dirección de red de un control de direcciones de red, analiza la cadena y comprueba si la cadena coincide con una máscara de tipo de dirección de red. Si la cadena coincide con la máscara, la función devuelve S_OK y devuelve la cadena en forma analizada a la aplicación que realiza la llamada (incluido el número de puerto, la longitud del prefijo y otra información de dirección), utilizando la estructura de NC_ADDRESS apuntada por pv. Esta macro devuelve E_INVALIDARG si la aplicación que realiza la llamada no puede asignar la estructura a la que apunta pv.
Las representaciones de las versiones 4 y 6 (v4/v6) del Protocolo de Internet (IP) para servicios y redes, así como direcciones de Internet y servicios con el formato sistema de nombres de dominio (DNS) se analizan. Si la cadena de dirección de red representa un nombre de host (DNS) o un servicio, el valor devuelto en el miembro PrefixLength de NC_ADDRESS es cero.
Establezca la máscara de tipo de dirección de red mediante la macro NetAddr_SetAllowType antes de llamar a la macro NetAddr_GetAddress .
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shellapi.h |