NCM_GETADDRESS mensaje
Indica si una dirección de red se ajusta a un tipo y formato especificados.
NCM_GETADDRESS
wParam = (WPARAM) (PNC_ADDRESS) pv;
lParam = 0;
Parámetros
-
wParam
- Debe ser cero.
-
pv [in, out]
- 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
Devuelve uno de los siguientes valores de tipo HRESULT.
| Código devuelto | Descripción |
|---|---|
|
La aplicación que llama no pudo asignar una estructura de NC_ADDRESS . |
|
El búfer de salida es demasiado pequeño para contener la dirección de red analizada. |
|
La cadena de dirección de red no es de ningún tipo especificado. |
|
La operación se realizó correctamente. |
|
No hay ninguna dirección en el control de direcciones de red para validar. |
Comentarios
Use el mensaje NCM_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 enviar este mensaje. Esto inicializa la biblioteca de controles comunes que contiene el control de direcciones de red.
Este mensaje 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, el mensaje devuelve S_OK y devuelve la cadena en formato analizado 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 a la que apunta pv. Este mensaje 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 con el mensaje NCM_SETALLOWTYPE antes de enviar la macro NCM_GETADDRESS .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
Consulte también