NCM_GETADDRESS messaggio
Indica se un indirizzo di rete è conforme a un tipo e formato specificato.
NCM_GETADDRESS
wParam = (WPARAM) (PNC_ADDRESS) pv;
lParam = 0;
Parametri
-
wParam
- Deve essere zero.
-
pv [in, out]
- Un puntatore a una struttura NC_ADDRESS per ricevere le informazioni sull'indirizzo di rete nel modulo analizzato, se il formato dell'indirizzo e il tipo nel controllo specificato da *hwnd* vengono convalidati. L'applicazione chiamante è responsabile dell'allocazione della memoria per questa struttura.
Valore restituito
Restituisce uno dei valori seguenti di tipo HRESULT.
| Codice restituito | Descrizione |
|---|---|
|
L'applicazione chiamante non è riuscita a allocare una struttura NC_ADDRESS . |
|
Il buffer out è troppo piccolo per contenere l'indirizzo di rete analizzato. |
|
La stringa di indirizzo di rete non è di alcun tipo specificato. |
|
L'operazione è stata completata. |
|
Non esiste alcun indirizzo nel controllo dell'indirizzo di rete da convalidare. |
Commenti
Usare il messaggio NCM_GETADDRESS per convalidare un indirizzo di rete in un controllo indirizzo di rete rispetto a una maschera di tipo di indirizzo di rete predefinita. Per creare un'istanza, usare la classe msctls_netaddress definita in Shellapi.h. Chiamare InitNetworkAddressControl in fase di esecuzione prima di inviare questo messaggio. In questo modo viene inizializzata la libreria dei controlli comuni che contiene il controllo dell'indirizzo di rete.
Questo messaggio ottiene la stringa di indirizzo di rete da un controllo indirizzo di rete, analizza la stringa e verifica se la stringa corrisponde a una maschera di tipo di indirizzo di rete. Se la stringa corrisponde alla maschera, il messaggio restituisce S_OK e restituisce la stringa in formato analizzato all'applicazione chiamante (incluso il numero di porta, la lunghezza del prefisso e altre informazioni sull'indirizzo), usando la struttura NC_ADDRESS puntata da pv. Questo messaggio restituisce E_INVALIDARG se l'applicazione chiamante non riesce ad allocare la struttura puntata da pv.
Le rappresentazioni degli indirizzi IP (Internet Protocol) 4 e 6 (v4/v6) per i servizi e le reti, nonché gli indirizzi Internet e i servizi denominati tramite il formato DNS (Domain Name System) vengono analizzate. Se la stringa di indirizzo di rete rappresenta un nome host denominato (DNS) o un servizio, il valore restituito nel membro PrefixLength di NC_ADDRESS è zero.
Impostare la maschera del tipo di indirizzo di rete usando il messaggio NCM_SETALLOWTYPE prima di inviare la macro NCM_GETADDRESS .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|
Vedi anche